Markdown-Syntax für PDF und Word — Farben, Tabellen, Formeln

Standard-Markdown funktioniert unverändert. Das hier versteht md-to-pdf-word zusätzlich; PDF und Word sehen gleich aus.

Dokumentangaben

Ganz oben in der Datei (optional):

---
title: Berichtstitel
subtitle: Untertitel
author: Autor / Team
date: today          # wird durch das heutige Datum ersetzt
abstract: Eine kurze Zusammenfassung.
page-size: A4        # A4 / A5 / B5 / 16K / letter / 17x24cm
number-sections: true
header: none         # keine Kopfzeile
heading-color: 365F91          # Überschriftenfarbe (eine pro Ebene: 365F91,4F81BD)
title-color: 17365D            # title-size: 26
caption-color: 4F81BD          # caption-size: 9  caption-bold: true
---

Ohne title wird kein Titelblock gedruckt.

Überschriften

# Ebene 1 … ##### Ebene 5. Für automatische Nummerierung unter „Weitere Optionen“ Überschriften nummerieren → Nummeriert wählen (KI-Assistenten nutzen den Parameter number_sections=true); dann keine Nummern wie „1.1“ selbst schreiben.

Textformate

Wirkung	Schreibweise
Fett / kursiv / durchgestrichen	`fett` `kursiv` `~~gestrichen~~`
Unterstrichen	`[Text]{.underline}` oder `<u>Text</u>`
Doppelt / wellig unterstrichen	`[Text]{.double-underline}` / `[Text]{.wave}`
Rahmen	`[Text]{.frame}`
Kapitälchen	`[Small Caps]{.smallcaps}`
Hervorhebung	`==Text==` oder `[Text]{bg=yellow}`
Farbe	`[Text]{color=red}`, `[Text]{color="#C00000"}`, `[Text]{color=primary}` (Stilfarbe)
Hintergrund	`[Text]{bg=green}` / `bg="#FFE0B2"`
Größe	`[Text]{size=14pt}`, `size=large` oder chinesische Größen wie `size=四号`
Schrift	`[Text]{font=serif}` (serif / sans / mono oder chinesisch 宋体 / 黑体 / 楷体 / 仿宋)
Kombiniert	`[Text]{color=red size=12pt font=sans .bold .underline}`
Hoch- / tiefgestellt	`E=mc^2^`, `H~2~O`
Inline-Code	`code`

Farbnamen: red blue green orange purple gray black yellow pink brown cyan teal navy, oder #RRGGBB, rgb(…).
Größen: 12pt, 16px, 1.2em oder chinesische Größen 初号小初一号小一二号小二三号小三四号小四五号小五六号.
Schalter lassen sich direkt schreiben: underline strike bold italic.
HTML funktioniert auch: <span style="color:#c00;font-size:16px;font-weight:bold">…</span>, <font color="red">, <mark>, <br>.
Verschachtelte Formate erben: [ein blauer Satz, [mit größerem rotem Teil]{color=red size=16pt}, dann wieder blau]{color=blue}.

Absatzformate

::: {align=center}
Ein zentrierter Absatz (right / left / justify ebenso)
:::

::: {align=center size=16pt color=primary font=sans}
Ein Format für den ganzen Block
:::

<div style="text-align:center">…</div> funktioniert ebenfalls. Ein Bild allein in einer Zeile wird automatisch zentriert.

Hinweisboxen

> [!NOTE]
> Hinweis (auch TIP / IMPORTANT / WARNING / CAUTION)

::: warning
Eine Box mit mehreren Absätzen.
:::

::: {.tip title="Eigener Titel"}
Inhalt
:::

Tabellen

Einfache Tabellen | a | b |, ausgerichtet mit :--- :---: ---:; eine Zeile : Tabellentitel unter der Tabelle ergibt eine nummerierte Beschriftung.
Kopfzeilen sind fett; Spaltenbreiten folgen dem Inhalt, langer Text bricht innerhalb der Seite um; lange Tabellen laufen über mehrere Seiten.
Verbundene Zellen: eine HTML-Tabelle verwenden:

<table>
  <caption>Tabellentitel</caption>
  <tr><th rowspan="2">Produkt</th><th colspan="2">Kennzahlen</th></tr>
  <tr><th>Umsatz</th><th>Gewinn</th></tr>
  <tr><td>A</td><td>1</td><td>2</td></tr>
</table>

Rastertabellen (+---+---+) unterstützen ebenfalls verbundene Zellen. - Zellen dürfen Farben, Fettdruck, Links und Inline-Code enthalten.

Bilder

![Beschriftung (nummeriert als „Figure N“)](images/chart.png){width=70%}
![](https://example.com/a.jpg){width=50%}

png / jpg / gif / svg / webp / bmp / tiff. Lokale Bilder zusammen mit dem Dokument hochladen (am einfachsten den ganzen Ordner); Web-Bilder werden automatisch geladen.
Mit Beschriftung → nummerierte Abbildung; ohne → nur das Bild. Ein fehlendes Bild wird zu grauem Platzhaltertext, statt die Umwandlung abzubrechen.
Eine bereits nummerierte Beschriftung (![Figure 3-1 Architektur](a.png)) behält ihre Nummer.

Teilabbildungen nebeneinander mit (a) (b):

::: {#fig:paar .subfigures}
![Links](a.png){width=45%} ![Rechts](b.png){width=45%}

Gemeinsame Beschriftung
:::

Formeln

Inline $E=mc^2$ oder $…$; abgesetzt $$…$$ oder \[…\] – die vollständige übliche Formelschreibweise (Matrizen, Integrale, Summen …). In Word werden daraus bearbeitbare Formeln. Preise wie „$100 und $200“ werden nicht als Formel missverstanden.

Fußnoten, Zitate, Listen, Code

Fußnoten: Text[^1] + [^1]: die Fußnote, oder inline ^[die Fußnote].
Zitate: > zitierter Text.
Listen: - / 1., verschachtelbar; Aufgabenlisten - [x]; keine Leerzeile vor einer Liste nötig.
Codeblöcke: ```python; lange Zeilen werden umbrochen.

Seitenumbrüche und Inhaltsverzeichnis

Seitenumbruch: eine Zeile nur mit \newpage,  oder ::: pagebreak + :::.
Inhaltsverzeichnis: eine Zeile [TOC] an der gewünschten Stelle; oder unter „Weitere Optionen“ Inhaltsverzeichnis ankreuzen (KI-Assistenten: toc=true), dann steht es nach dem Titel.

Erweitertes Layout

Querformatseiten: breite Tabellen oder Abbildungen zwischen ::: landscape und ::: setzen.
Nummerierte Formeln: $$ V=\frac{a}{r} $$ {#eq:rendite} wird (1), (2) … nummeriert; [@eq:rendite] im Text verweist mit Link darauf.
Verweise auf Tabellen, Abbildungen, Abschnitte: : Beschriftung {#tbl:name}, ![Beschriftung](a.png){#fig:name}, ## Überschrift {#sec:name}; [@tbl:name] → „Table 1“.
Literatur: bibliography: refs.bib in die Dokumentangaben (die .bib mit hochladen); zitieren mit [@schluessel] oder [@a; @b] → [1], [2,3]; das Verzeichnis entsteht im Stil GB/T 7714—2015.
Teil-Inhaltsverzeichnis: eine Zeile [本部分目录] unter der Überschrift eines Teils listet nur dessen Abschnitte.
Seitenzählung neu beginnen: eine Zeile [页码重置] am Anfang eines neuen Teils.
Seitenverweise: siehe Seite [@page:sec:name] → „siehe Seite 5“; ein fehlendes Ziel wird rot markiert und gemeldet.
Anhänge: eine Zeile [附录] beginnt die Anhänge; jede folgende Überschrift der Ebene 1 wird „Appendix A …“ auf neuer Seite, mit Nummern wie Table A.1, Figure B.1, (A.1).

Titelseite

cover: in die Dokumentangaben aufnehmen; die Titelseite steht für sich, die Seitenzählung des Textes beginnt bei 1:

title: Immobilienbewertung
cover:
  logo: logo.png                     # optional
  number: Bericht Nr. 2026-0123      # optional
  items:                             # optional: ausgerichtete Bezeichnungen, unterstrichene Werte
    - Auftraggeber: Beispielbank
    - Gutachterin: Erika Muster
  org: Beispiel Gutachten GmbH
  date: today

cover: true allein erzeugt eine einfache Titelseite aus title / subtitle / author / date.

Chinesische Amtsdokumente (GB/T 9704)

Ein gongwen:-Block schaltet auf das Layout für Amtsdokumente um (oder den Stil „Amtsdokument“ wählen): Satzspiegel 156 × 225 mm, Fangsong Größe 3, 22 Zeilen × 28 Zeichen, Seitenzahlen „— 1 —“ rechts auf ungeraden und links auf geraden Seiten. Die Schlüssel sind wie in der Norm chinesisch:

title: 关于做好2026年度安全生产工作的通知
gongwen:
  份号: "000123"             # alles optional; fehlende Elemente entfallen
  密级: 机密★1年              # Geheimhaltung
  紧急程度: 特急              # Dringlichkeit
  发文机关标志: 某某市人民政府文件   # roter Briefkopf
  发文字号: 某政发〔2026〕12号      # Aktenzeichen
  签发人: 张三                # Unterzeichner (an übergeordnete Stellen)
  主送机关: 各区县人民政府，市政府各部门：   # Empfänger
  发文机关署名: 某某市人民政府     # ausstellende Behörde (Unterschrift)
  成文日期: 2026-10-24       # Datum, geschrieben 2026年10月24日; today möglich
  印章: 是                   # 是 = mit Siegel, 否 = ohne Siegel
  附注: （此件公开发布）       # Vermerk
  抄送: 市委各部门。          # Kopie an
  印发机关: 某某市人民政府办公室   # gedruckt von
  印发日期: 2026-10-24       # Druckdatum

Gliederungsebenen: # 一、… (Heiti), ## （一）… (Kaiti), ### 1. …, #### （1）… (Fangsong); mit eingeschalteter Nummerierung werden die Zahlen ergänzt.
Anlagen: jede in ::: 附件 … ::: setzen; ihre erste Überschrift ist der Titel der Anlage. Sie beginnen auf neuer Seite und werden nach dem Text aufgeführt.
In Word ersetzt eine fette Song-Schrift FZXiaoBiaoSong für Titel; ist sie bei den Lesern installiert, heading-font: 方正小标宋简体 angeben.

Gut zu wissen

Nicht das ganze Dokument in einen ```markdown-Codeblock setzen (falls doch, wird die Hülle entfernt).
Emoji und seltene Symbole nutzen im PDF Ersatzschriften; Word behält die Originalzeichen.