Markdown zu PDF — für Reports, Docs und README-Exporte

Was es macht

Die API nimmt einen Markdown-String (CommonMark oder GitHub-Flavored Markdown) entgegen und liefert ein PDF mit nativer Typografie. Kein Zwischenschritt über HTML nötig, keine eigene Template-Logik — Markdown rein, PDF raus.

Minimaler Request

curl -X POST https://api.dokmatiq.com/v1/convert/markdown-to-pdf \
  -H "Authorization: Bearer $DOKMATIQ_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "# Quartalsbericht Q1 2026\n\nUmsatz: **€ 1.240.000**\n\n| Region | Umsatz |\n|---|---|\n| DACH | 820.000 |\n| EU | 420.000 |",
    "format": "A4",
    "theme": "default"
  }' \
  -o bericht.pdf

Response: Content-Type: application/pdf, Status 200.

Unterstützte Markdown-Features

• Überschriften H1–H6 mit automatischer Struktur­erkennung (Tagged PDF bei outputProfile: "PDF/UA-1")
• Tabellen (GFM) mit automatischer Ausrichtung
• Fenced Code-Blöcke mit Syntax-Highlighting für 180+ Sprachen
• Fußnoten, Definitions­listen (Extended Markdown)
• Aufgaben-Listen (- [ ], - [x])
• Inline-HTML (sauber sanitisiert)
• Front Matter (YAML) — wird für Metadaten wie title, author, date genutzt

Themes

Drei eingebaute Themes, plus Custom-Theme via CSS:

Theme	Charakter
default	Neutrale Serif-Typografie, für Berichte und Dokumentation
technical	Monospace-Headings, Fokus auf Code und Technik
stationery	Minimales Layout, damit Briefpapier durchscheint
custom	Eigene CSS-Datei per customCss-Parameter

Mit Briefpapier-Overlay

{
  "markdown": "# Monatsbericht April 2026\n\nSehr geehrte Damen und Herren,\n\nhiermit übersenden wir Ihnen…",
  "theme": "stationery",
  "stationery": {
    "firstPage": "base64:JVBERi0xLjQ...",
    "subsequentPages": "base64:JVBERi0xLjQ..."
  },
  "contentArea": { "x": 25, "y": 60, "width": 160, "height": 200 }
}

Der Markdown-Text fließt in die definierte contentArea (in mm), umfließt Seitenumbrüche automatisch und landet auf dem hochgeladenen Briefpapier.

Wofür man es einsetzt

• Dokumentations-Exporte aus MkDocs/Docusaurus/Markdown-Repos als druckbare Versionen
• Quartalsberichte aus strukturierten Zahlen + Markdown-Beschreibung
• Technische Änderungsprotokolle (Changelogs) für Kunden als PDF
• Interne Memos auf Briefpapier, Inhalt aus dem Wiki
• Produkt-Readmes als professionelle Datenblätter

Vergleich mit Alternativen

	Dokmatiq Markdown-zu-PDF	Pandoc + LaTeX	md-to-pdf (Node)	Markdown → HTML → Chrome
Setup	API-Call	LaTeX installieren	Node, Puppeteer	Zwei Pipelines
Tabellen	nativ	gut	gut	gut
Syntax-Highlighting	nativ	erweiterbar	nativ	selbst einbauen
Briefpapier-Overlay	nativ	komplex	nein	über Stationery-Tool
PDF/A	direkt per Flag	über Zusatz­pakete	nein	Nachbearbeitung
Skalierung	API-seitig	selbst	selbst	selbst

Pandoc ist unschlagbar, wenn man wissenschaftliche Dokumente mit mathematischen Formeln und Zitier­stilen braucht. Für Geschäfts-PDFs ist Dokmatiq schneller und erfordert kein LaTeX-Wissen.

Häufige Stolpersteine

1. Tabellen zu breit — GFM-Tabellen brechen nicht automatisch um; lange Spalten per columnWidths explizit setzen
2. Code-Blöcke über Seitenumbruch — per CSS-Custom-Theme break-inside: avoid für <pre> erzwingen
3. Umlaute in Code-Blöcken — die eingebettete Schrift muss Unicode unterstützen; theme: "custom" mit passenden Fonts hilft
4. HTML-Inlines aggressiv sanitisiert — erwartete <script> oder <iframe> werden entfernt (Security-Default); bei Bedarf allowUnsafeHtml: true (nicht empfohlen für fremde Inputs)