Pandoc reference.docx erstellen: Markdown zu gebrandetem Word
Markdown liefert Ihnen eine saubere Single Source of Truth, aber früher oder später verlangt jemand eine Word-Datei, die aussieht, als stamme sie wirklich aus Ihrem Unternehmen: Hausschriften, gebrandete Überschriften, konsistente Seitenränder. Pandoc löst das mit einer einzigen Datei: dem reference docx. Jeder Stil im exportierten Dokument — Überschriften, Fließtext, Tabellen, Fußnoten — wird aus dieser Datei geerbt. Eine gute Vorlage entscheidet also darüber, ob Sie einen beliebigen Dump oder ein versandfertiges Dokument erhalten.
Dieser Artikel erklärt, wie ein reference docx funktioniert, wie Sie eines erstellen, welche Stile Ihre Aufmerksamkeit verdienen und wie Sie das Ergebnis testen, ohne sich im Kreis zu drehen. Die Prinzipien gelten gleichermaßen für die Kommandozeile und den Browser — und ein fertiges reference docx lässt sich direkt an Pandocs --reference-doc-Flag übergeben.
Warum das reference docx alles entscheidet
Wenn Pandoc eine docx-Datei schreibt, kopiert es nicht das Layout Ihres Markdown. Es erzeugt ein frisches Dokument und hängt benannte Stile an jedes Element: Heading 1 für Abschnitte der obersten Ebene, Body Text für gewöhnliche Absätze, Table Caption für Tabellenunterschriften. Word entscheidet dann, wie diese Stile aussehen — und die Definitionen stammen aus dem von Ihnen gelieferten reference docx.
Der Inhalt der Referenzdatei selbst wird ignoriert. Zählen tun nur ihre Stile und Dokumenteigenschaften: Seitengröße, Seitenränder, Kopf- und Fußzeilen, sogar die Standardsprache. Diese Trennung macht das System stabil. Sie bearbeiten nie die erzeugte Ausgabe von Hand; Sie bearbeiten die Vorlage einmal, und jede künftige Konvertierung übernimmt die Änderung automatisch.
Ihre erste Vorlage erstellen
Es gibt zwei praktikable Ausgangspunkte. Der erste: Lassen Sie Pandoc seine eigene Standardvorlage ausgeben — rufen Sie pandoc mit dem Argument --print-default-data-file reference.docx auf und speichern Sie die Ausgabe etwa als custom-reference.docx. Öffnen Sie die Datei in Word, passen Sie die gewünschten Stile an und speichern Sie. Da Sie von Pandocs eigener Datei ausgehen, ist jeder Stil, den der Writer verwenden kann, bereits vorhanden und korrekt benannt.
Der zweite Weg geht von echter Ausgabe aus. Konvertieren Sie zuerst ein repräsentatives Markdown-Dokument nach docx, öffnen Sie das Ergebnis und gestalten Sie es direkt um. Das hält Sie ehrlich, denn Sie bearbeiten exakt die Struktur, die Ihre Leser sehen werden — inklusive der Eigenheiten Ihrer tatsächlichen Inhalte statt einer abstrakten Mustervorlage.
Die wichtigsten Stile
Beginnen Sie mit der Überschriftenleiter. Heading 1 bis Heading 6 geben dem ganzen Dokument den Ton vor — passen Sie dort zuerst Schrift, Größe, Abstände und Nummerierung an. Title, Subtitle, Author und Date gestalten den Titelblock, der erscheint, wenn Ihr Markdown YAML front matter mit diesen Feldern enthält. Body Text steuert gewöhnliche Absätze, und First Paragraph erlaubt es, den Absatz nach einer Überschrift anders zu behandeln — ein verbreiteter typografischer Trick, um den Einzug zu streichen.
Übersehen Sie Compact nicht, den Stil, den Pandoc auf enge Listen anwendet. Wirken Ihre Listen gedrängt oder zu locker, ist das der Stil, den Sie korrigieren müssen. Mit diesen wenigen Stilen decken Sie das meiste ab, was ein Leser auf einer Seite wahrnimmt — und keiner davon erfordert Words exotischere Dialoge.
Tabellen, Fußnoten und Bildunterschriften
Tabellen werden über den Stil Table gestaltet, der Rahmen, Zellabstände und die Schattierung der Kopfzeile steuert. Words Tabellenformat-Editor ist fummelig — rechnen Sie damit, hier mehr Zeit zu verbringen als bei den Überschriften. Der Gewinn: Jede konvertierte Tabelle erbt konsistente Regeln statt der nackten Vorgaben, mit denen der Writer ausgeliefert wird.
Footnote Text steuert den Notentext am Seitenfuß, Footnote Reference das hochgestellte Zeichen im Fließtext. Image Caption und Table Caption behandeln die Unterschriften, die Pandoc an Abbildungen beziehungsweise Tabellen hängt. Einmal gestaltet, bleiben lange Dokumente vom ersten Kapitel bis zum letzten Anhang konsistent.
Codeblöcke und Formeln
Codeblöcke landen im Stil Source Code, Inline-Code wird in Verbatim Char verpackt. Geben Sie Source Code eine Monospace-Schrift, eine helle Hintergrundschattierung und sinnvolle Zeilenabstände, und technische Dokumente wirken sofort durchdacht. Syntax-Highlighting-Farben werden, sofern aktiviert, über den Stil gelegt — die Grundformatierung übersteht also jedes Highlight-Theme.
Formeln gehen einen völlig anderen Weg. Pandoc wandelt TeX-Notation in Words natives OMML-Formelformat um — Formeln kommen also als echte, bearbeitbare Gleichungen an, nicht als Bilder. Ihr Aussehen folgt der Mathematikschrift des Dokuments, die Word standardmäßig auf Cambria Math setzt. Hier müssen Sie selten etwas umgestalten; wichtig ist nur zu wissen, dass Gleichungen außerhalb des Absatzformatsystems leben.
Vorlage einsetzen und den Kreis schließen
Auf der Kommandozeile ist die ganze Schleife ein einziges Flag: pandoc --reference-doc=custom-reference.docx input.md -o output.docx. Der Markdown-zu-Word-Export dieser Website nutzt derzeit Pandocs eingebaute Stile, und die Pro-Vorlagenoption akzeptiert eine Pandoc-Textvorlage für Markdown-, HTML-, RST- und LaTeX-Ausgabe — für gebrandete docx ist das reference docx plus CLI-Flag heute der verlässliche Weg.
Machen Sie das Testen zu einer Schleife, nicht zu einem Ereignis. Ändern Sie ein oder zwei Stile, konvertieren Sie dasselbe Beispieldokument erneut und vergleichen Sie mit der vorherigen Ausgabe. Das Iterieren mit einer kleinen, repräsentativen Datei — zwei Überschriftenebenen, eine Tabelle, eine Fußnote und ein Codeblock — bringt Probleme in Sekunden ans Licht und bewahrt Sie vor blindem Umgestalten.
Die Vorlage an Redaktionen und Verlage übergeben
Das fertige reference docx ist ein kleines, in sich geschlossenes Artefakt, das Ihre gesamte visuelle Identität kodiert: Schriften, Seitenränder, Kopf- und Fußzeilen, Überschriftenfarben. Legen Sie es neben Ihren Inhalten in der Versionsverwaltung ab, benennen Sie es eindeutig, und jedes Teammitglied kann markenkonforme Word-Dateien aus Markdown erzeugen, ohne Words Formatdialoge anzufassen.
Auch Redaktionen und Verlage profitieren, denn das Dokument kommt mit echten benannten Stilen statt mit Direktformatierung — ihre eigenen Vorlagen können nachgelagert alles neu mappen oder überschreiben. Eine Markdown-Quelle und eine Vorlagendatei können dann eine Website, eine PDF-Pipeline und ein Word-Deliverable bedienen, ohne manuelle Nachformatierung.