MD2Word – Markdown-zu-Word-Konverter

DIE IDEE

MD2Word – Markdown-zu-Word-Konverter

Typ: Software Status: MVP Tech Stack: Python, markdown-it-py, python-docx, Pillow, tkinter, Mermaid CLI (mmdc), PlantUML, Graphviz, Docker, PyInstaller Problemstellung Entwickler und technische Redakteure schreiben Dokumentation häufig in Markdown, Kunden und Stakeholder erwarten aber ein Word-Dokument. Einfache Konverter übernehmen zwar den Text, lassen eingebettete Diagramme (Mermaid, PlantUML, Graphviz) jedoch als Quellcode stehen und liefern kaum ein ansprechendes Layout. Gebraucht wird ein lokal laufendes Werkzeug, das aus Markdown samt Diagrammen ein weitergebbares, sauber formatiertes .docx erzeugt. Beschreibung MD2Word wandelt Markdown-Dateien in professionell formatierte Word-Dokumente (.docx) um. Der Text wird mit markdown-it-py in einen Token-Stream geparst und über python-docx — inklusive direkter OOXML-Manipulation für Schattierungen, Rahmen und Farbschema — in ein durchgestyltes Dokument überführt: mit Überschriften H1–H6, Tabellen mit Zebra-Streifen, Codeblöcken, Blockzitaten, verschachtelten Listen und eingebetteten Bildern. Diagramm-Codeblöcke (Mermaid, PlantUML, Graphviz/DOT) werden über externe CLI-Tools zu PNG-Grafiken gerendert und eingebettet; fehlt ein Tool, erscheint der Block als Code. Bedienbar ist das Tool per Kommandozeile, über eine tkinter-GUI mit Fortschrittsanzeige, per Docker (alle Diagramm-Tools vorinstalliert) und als eigenständige Windows-EXE. Bekannte Grenzen: Links werden nur optisch formatiert statt klickbar, Tabellenzellen verlieren Inline-Formatierung und HTML wird entfernt; automatisierte Tests fehlen, und der Code ist seit Februar 2026 unverändert. Anwendungsfall Aus einer Markdown-Datei mit Text, Tabellen und Diagrammen per Klick oder Befehl ein sauber formatiertes Word-Dokument machen, das man Kunden oder Kollegen weitergeben kann. Link: https://github.com/rawk7000/markdown_to_word (öffentliches Repo)