xmind2markdown 0.0.0__py3-none-any.whl

xmind2markdown-0.0.0.dist-info/METADATA

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: xmind2markdown
+Version: 0.0.0
+Summary: XMind to Markdown converter
+Author-email: Frithjof Engel <frithjof@fms-engel.de>
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+License-File: LICENSE
+Dynamic: license-file

xmind2markdown-0.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+xmind2markdown.py,sha256=vz7efktfz7DHwLz7UVPBQW__7J-yTJStoXnQw-GpdyY,2866
+xmind2markdown-0.0.0.dist-info/licenses/LICENSE,sha256=86XC26qqBYxhYYXHDIZdMILbYiAHgs7Zzu7NC5Q8tck,1071
+xmind2markdown-0.0.0.dist-info/METADATA,sha256=Ela5qmKo1HfeuFL9ToDY6EuHc9D0h_JHlF41S9N1GUw,311
+xmind2markdown-0.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+xmind2markdown-0.0.0.dist-info/entry_points.txt,sha256=X1_Hr0jmr2Rwz1dByXsKxJ0zkGQcRh6vZ2GOWZV4Hx0,55
+xmind2markdown-0.0.0.dist-info/top_level.txt,sha256=k5xSje_aCumVqTx4jGYp6LzU1ArZQ4m0Potxg4eUjCI,15
+xmind2markdown-0.0.0.dist-info/RECORD,,

xmind2markdown-0.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

xmind2markdown-0.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+xmind2markdown = xmind2markdown:main

xmind2markdown-0.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Frithjof Engel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

xmind2markdown-0.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+xmind2markdown

xmind2markdown.py

@@ -0,0 +1,98 @@
+import zipfile
+import json
+from pathlib import Path
+
+MARKER_MAP = {
+    "task-start": "○",
+    "task-quarter": "◔",
+    "task-half": "◑",
+    "task-3quar": "◕",
+    "task-done": "✔",
+
+    "task-oct": "○",    # TODO: Find unicode symbol for octets
+    "task-3oct": "◔",   # TODO: Find unicode symbol for octets
+    "task-5oct": "◑",   # TODO: Find unicode symbol for octets
+    "task-7oct": "◕",   # TODO: Find unicode symbol for octets
+
+    "priority-1": "①",
+    "priority-2": "②",
+    "priority-3": "③",
+    "priority-4": "④",
+    "priority-5": "⑤",
+    "priority-6": "⑥",
+    "priority-7": "⑦",
+    "priority-8": "⑧",
+    "priority-9": "⑨",
+
+    "symbol-star": "⭐",
+    "symbol-exclam": "❗",
+    "symbol-wrong" : "❌)", 
+
+    "flag-red": "🚩", 
+}
+
+def markdown_heading(text: str, level: int) -> str:
+    return f"{'#' * level} {text}\n\n"
+
+def markdown_note(note: str) -> str:
+    return f"> {note.strip()}\n\n"
+
+def xmind_to_markdown(zf: zipfile.ZipFile) -> str:
+    content = json.loads(zf.read("content.json"))
+    markdown = []
+
+    def extract_markers(topic: dict) -> str:
+        markers_str = ""
+        for m in topic.get("markers", []):
+            marker = m["markerId"]
+            if marker in MARKER_MAP:
+                 markers_str += MARKER_MAP[marker]
+            else: 
+                print("Marker could not be converted: "+marker)
+     
+        return markers_str
+
+
+    def parse_topic(topic, level=1):
+        markers = extract_markers(topic)
+        title = markers + topic.get("title", "Untitled")
+
+        markdown.append(markdown_heading(title, level))
+
+        note = topic.get("notes", {}).get("plain", {}).get("content")
+        if note:
+            markdown.append(markdown_note(note))
+
+        for child in topic.get("children", {}).get("attached", []):
+            parse_topic(child, level + 1)
+
+    for sheet in content:
+        parse_topic(sheet["rootTopic"])
+
+    return "".join(markdown)
+
+def convert_xmind2markdown(xmind_file: Path, markdown_file: Path):
+        with zipfile.ZipFile(xmind_file) as zf:
+            if "content.json" in zf.namelist():
+                markdown = xmind_to_markdown(zf)
+                markdown_file.write_text(markdown, encoding="utf-8")
+            else:
+                raise RuntimeError("XMind file could not be opened. Only XMind Files in modern format are supported.")
+
+# -----------------------------
+# CLI entry point
+# -----------------------------
+def main(): 
+    import sys
+    
+    if len(sys.argv) == 3:
+        xmind_file = Path(sys.argv[1])
+        markdown_file = Path(sys.argv[2])
+        convert_xmind2markdown(xmind_file, markdown_file)
+        print("XMind file was converted to "+markdown_file.name)
+    else:
+        print("Usage: xmind2markdown input.xmind output.md")
+        sys.exit(1)
+
+if __name__ == '__main__':
+    main()