Markdown in Word umwandeln: Pandoc & Kommandozeile

Wer Markdown über die Kommandozeile in Word umwandeln will, landet bei pandoc – und im Grunde reicht dafür eine einzige Zeile:

pandoc report.md -f gfm -o report.docx

Für die meisten Dokumente ist damit alles erledigt. Was die üblichen Einzeiler-Tutorials verschweigen: An welchen Stellen der Befehl nicht mehr genügt. Und vieles, was über pandocs Grenzen geschrieben wurde, ist schlicht veraltet. Ich habe pandoc 3.7.0.2 auf ein Testdokument losgelassen, vollgepackt mit Tabellen, Aufgabenlisten, LaTeX-Gleichungen und einem Mermaid-Diagramm – und die erzeugte .docx-Datei anschließend entpackt, um nachzusehen, was tatsächlich herauskam. Einige Ergebnisse haben mich überrascht.

Dieser Leitfaden führt durch die Installation, die wichtigsten Befehle, das DOCX-Styling und die Batch-Konvertierung – und liefert auf Basis dieses Tests eine ehrliche Landkarte: wo pandoc bricht und wann ein Online-Konverter die bessere Wahl ist.

👉 Direkt zu den Testergebnissen | Zum Vergleich Kommandozeile vs. Online

Pandoc installieren

Pandoc ist eine einzelne Binärdatei mit Installern für alle großen Plattformen:

• macOS: brew install pandoc
• Windows: winget install --id JohnMacFarlane.Pandoc (oder der MSI-Installer)
• Debian/Ubuntu: sudo apt install pandoc

Ein Vorbehalt, bevor Sie einem alten Systempaket vertrauen: Distributions-Repositories liefern oft pandoc-Versionen aus, die Jahre hinterherhinken. Ubuntu LTS hat lange 2.x ausgeliefert, während die aktuelle Release-Linie bei 3.x liegt – und wie Sie weiter unten sehen werden, entscheidet das Versionsalter darüber, was sauber konvertiert. Prüfen Sie Ihre Version mit pandoc --version.

Der Grundbefehl, erklärt

Der Minimalbefehl funktioniert, aber in echten Projekten leisten drei Flags die eigentliche Arbeit:

pandoc report.md -f gfm -o report.docx --toc

Warum -f gfm statt pandocs eigenem Markdown-Dialekt? Weil das Markdown, das heute die meisten schreiben – in GitHub-READMEs, in ChatGPT- und Claude-Ausgaben, in Notion-Exporten – GFM ist. Pandocs Standarddialekt ist akademischer geprägt: Er aktiviert Fußnoten und Zitationen, interpretiert aber einige Konstrukte anders. Stammt Ihre Quelle von einem KI-Assistenten oder einem Entwickler-Tool, ist gfm der sicherere Reader.

Anmerkung zu Formeln: Mit dem GFM-Reader funktioniert Mathematik in $...$ und $$...$$ in aktuellem pandoc einfach. Gleichungen werden zu nativen Word-Gleichungen, nicht zu Bildern. Dazu unten mehr, denn kaum ein pandoc-Verhalten wird im Netz so häufig falsch dargestellt.

Die Ausgabe mit einem Referenzdokument stylen

Ein von pandoc erzeugtes DOCX öffnet sich in Word mit generischem Styling. Soll das Dokument einer Firmenvorlage entsprechen, lösen Sie das nicht mit Flags, sondern mit einem Referenzdokument (reference-doc).

Der Workflow besteht aus drei Schritten:

1. Erzeugen Sie pandocs Standardvorlage als Ausgangspunkt:

   pandoc -o custom-reference.docx --print-default-data-file reference.docx
   

2. Öffnen Sie custom-reference.docx in Word und bearbeiten Sie die Formatvorlagen – Überschrift 1, Standard, Tabelle, Codeblöcke. Der Textinhalt dieser Datei wird ignoriert; nur Stile und Seiteneinrichtung werden übernommen.

3. Konvertieren Sie mit angewendeter Vorlage:

   pandoc report.md -f gfm --reference-doc=custom-reference.docx -o report.docx
   

Das pandoc-Handbuch dokumentiert, welche Stilnamen berücksichtigt werden. Das mentale Modell, mit dem es klick macht: Sie stylen kein Dokument. Sie bringen pandoc einmal die Word-Stile Ihrer Organisation bei – und verwenden sie danach bei jeder Konvertierung wieder.

Mehrere Dateien im Batch konvertieren

Hier schlägt die Kommandozeile jedes Web-Tool. Ein ganzer Ordner in einem Durchgang:

Bash (macOS/Linux):

for f in docs/*.md; do
  pandoc "$f" -f gfm -o "${f%.md}.docx"
done

PowerShell (Windows):

Get-ChildItem docs -Filter *.md | ForEach-Object {
  pandoc $_.FullName -f gfm -o ($_.FullName -replace '\.md$', '.docx')
}

Und weil pandoc nur eine einzige Abhängigkeit ist, lässt es sich ohne Umstände in CI einbauen. Ein GitHub-Actions-Schritt, der bei jedem Push Word-Kopien Ihrer Dokumentation neu erzeugt, sieht so aus:

- uses: pandoc/actions/setup@v1
- run: |
    for f in docs/*.md; do
      pandoc "$f" -f gfm --reference-doc=brand.docx -o "out/$(basename "${f%.md}").docx"
    done

Teams nutzen dieses Muster, um für Compliance-Reviews oder Kundenlieferungen einen Word-Spiegel eines Markdown-Wikis zu pflegen. Konvertieren Sie denselben Satz Dateien öfter als zweimal, hat sich das Skript sofort bezahlt gemacht.

Wo Pandoc an seine Grenzen stößt (getestet mit 3.7)

Hier der Testaufbau: eine einzige Markdown-Datei mit einer Tabelle, einer Aufgabenliste, Inline-Mathematik ($E = mc^2$), einer mehrzeiligen Display-Gleichung, einem Mermaid-Flowchart und einem GFM-Alert-Block. Konvertiert mit pandoc 3.7.0.2, danach die .docx entpackt und word/document.xml direkt gelesen. Drei Befunde.

Formeln funktionieren besser als ihr Ruf

Das Dokument-XML enthält zwei <m:oMath>-Blöcke – einen pro Gleichung. Das ist OMML, Words natives Gleichungsformat. Beide Gleichungen sind im Formel-Editor von Word voll bearbeitbar, rendern in Druckqualität und überstehen Copy-Paste in andere Office-Dokumente.

Das widerspricht einer Behauptung, die sich in älteren Tutorials hartnäckig hält (und bis vor Kurzem auch in einem unserer eigenen Guides stand): dass komplexes LaTeX zu Bildern gerastert wird. In aktuellem pandoc passiert das nicht. Standard-LaTeX-Mathematik – Brüche, Summen, griechische Buchstaben, Indizes – wird ohne Zusatzaufwand zu nativen Gleichungen.

Die ehrliche Grenze: pandoc versteht die Standard-LaTeX-Mathesyntax, nicht beliebiges LaTeX. Eigene \newcommand-Makros, TikZ-Grafiken und paketabhängige Umgebungen schaffen den Sprung nicht. Und wenn Ihre Distribution pandoc 2.x ausgeliefert hat, verhält sich das Tool anders – prüfen Sie pandoc --version, bevor Sie pandoc die Schuld geben.

Mermaid ist die eigentliche Bruchstelle

Aus dem Mermaid-Flowchart wurde kein Diagramm. Er kam als wörtlicher Monospace-Text an – der rohe flowchart LR-Quellcode, formatiert als Codeblock. Das Dokument-XML zeigt null Zeichnungsobjekte.

Das wiegt heute schwerer als noch vor fünf Jahren, denn KI-Assistenten lieben Mermaid. Bitten Sie ChatGPT oder Claude um eine Architekturübersicht, enthält die Antwort mit guter Wahrscheinlichkeit einen mermaid-Codeblock. Konvertieren Sie diese Unterhaltung mit pandoc, steht in Ihrem Word-Dokument etwas, das wie liegengebliebener Quellcode aussieht. Wenn das Ihr Workflow ist: Unser Guide zum Export von ChatGPT-Ausgaben nach Word behandelt die KI-spezifischen Details.

Es gibt eine CLI-Lösung: mermaid-filter, ein pandoc-Filter, der Diagramme während der Konvertierung rendert. Er funktioniert, aber wägen Sie den Aufwand ehrlich ab – es ist ein npm-Paket, das über Puppeteer ein Headless-Chromium mitbringt, und der pandoc-Aufruf wird zu pandoc -F mermaid-filter .... Für eine Dokumentations-Pipeline, die täglich Diagramme konvertiert, amortisiert sich die Einrichtung. Für den einen Bericht, der heute Nachmittag fällig ist, ist sie ein Umweg.

Kleine Genauigkeitsverluste an den Rändern

Zwei leisere Befunde aus demselben Test. GFM-Alert-Blöcke (> [!NOTE]) behalten ihren Text, verlieren aber die farbige Callout-Darstellung – in Word erscheinen sie als gewöhnliche Blockzitate. Und Aufgabenlisten-Einträge kommen als schlichter Listentext an, nicht als Word-Checkbox-Steuerelemente. Beides zerstört kein Dokument; beides plättet aber Formatierung, die der Autor vermutlich bewusst gewählt hat. Geht Ihre Konvertierung auf andere Weise schief, haben wir die häufigen Fehlerbilder in typische Markdown-Konvertierungsprobleme katalogisiert.

Kommandozeile oder Online-Konverter: was wann?

Nach diesem Test – hier das Entscheidungsraster, das ich selbst verwenden würde:

Beide Wege sind legitim. Pandoc verdient seinen Platz in jeder wiederkehrenden Pipeline. Für den einmaligen Fall „ich brauche das in fünf Minuten als .docx" – besonders wenn Mermaid im Spiel ist – liefert ein kostenloser Online-Konverter von Markdown zu Word ein sauberes Dokument mit Gleichungen und gerenderten Diagrammen, ganz ohne Installation.

Häufig gestellte Fragen

F: Kann ich Markdown in Word umwandeln, ohne etwas zu installieren?
A: Nicht über die Kommandozeile – pandoc muss installiert werden. Wenn Softwareinstallation keine Option ist, sind browserbasierte Konverter der praktikable Weg; die Konvertierung läuft serverseitig, und Sie laden die fertige .docx herunter.

F: Konvertiert pandoc LaTeX-Mathematik in echte Word-Gleichungen?
A: Ja. Im Test mit pandoc 3.7.0.2 wurden sowohl Inline- als auch Display-Mathematik zu nativen OMML-Gleichungen, bearbeitbar im Formel-Editor von Word. Die Ausnahmen: sehr alte pandoc-Versionen und eigene LaTeX-Makros.

F: Warum erscheint mein Mermaid-Diagramm in Word als Code?
A: Pandoc behandelt einen mermaid-Codeblock als wörtlichen Code – Diagramme rendert es nicht. Entweder Sie ergänzen Ihre Pipeline um mermaid-filter (setzt Node.js voraus), oder Sie nutzen einen Konverter mit eingebautem Mermaid-Rendering.

F: Wie behalte ich die Schriften und Überschriftenstile meiner Firma?
A: Mit --reference-doc=template.docx. Bearbeiten Sie die Formatvorlagen in dieser Vorlage einmal in Word; pandoc wendet sie bei jeder Konvertierung an. Der Inhalt der Vorlage wird ignoriert, nur die Stile werden übernommen.

F: Was ist der Unterschied zwischen -f markdown und -f gfm?
A: markdown ist pandocs eigener erweiterter Dialekt (Fußnoten, Zitationen); gfm entspricht dem, was GitHub, ChatGPT und die meisten modernen Tools erzeugen – Tabellen, Aufgabenlisten, Durchgestrichenes. Für KI-generiertes oder von Entwicklern geschriebenes Markdown liefert gfm weniger Überraschungen.

F: Kann pandoc Word zurück in Markdown konvertieren?
A: Ja – drehen Sie die Argumente um: pandoc report.docx -o report.md. Beim Hin- und Herkonvertieren geht Word-spezifische Formatierung verloren (Textfelder, Kommentare); betrachten Sie es als Inhaltsmigration, nicht als verlustfreien Kreislauf.

Verwandte Ressourcen

• Der komplette Markdown-zu-Word-Guide: das gesamte Spektrum der Konvertierungsoptionen jenseits der Kommandozeile
• ChatGPT zu Word: der Markdown-Workflow für KI-generierte Dokumente
• Markdown zu PDF: wenn das Lieferobjekt stattdessen ein PDF ist
• Typische Markdown-Konvertierungsprobleme: Lösungen für kaputte Tabellen, Encoding-Probleme und Formatierungsdrift

Fazit

Pandoc bleibt die richtige Antwort auf „Markdown über die Kommandozeile in Word umwandeln" – ein Befehl für eine Einzeldatei, ein kurzes Skript für einen Ordner, --reference-doc für das Firmen-Styling. Unser Test hat gezeigt: Die Formelunterstützung ist besser als ihr Ruf. Standard-LaTeX wird zu echten, bearbeitbaren Word-Gleichungen.

Die tatsächliche Lücke ist visuell: Mermaid-Diagramme kommen als Quellcode an, sofern Sie keine Node-basierte Filterkette anschrauben. Entscheiden Sie also nach Workflow. Wiederkehrende Pipeline mit reinen Textdokumenten: mit pandoc skripten. Einzeldokument mit Diagrammen und Deadline: im Browser konvertieren und Gleichungen wie Flowcharts intakt halten.

Referenzen

• Pandoc User's Guide — offizielles Handbuch: Reader, Writer, --reference-doc, Formelbehandlung
• Installing pandoc — offizielle Installer für alle Plattformen
• mermaid-filter — Community-Filter für pandoc zum Rendern von Mermaid-Diagrammen
• pandoc/actions — offizielle GitHub Actions für pandoc in CI