Markdown zu PDF: 5 Methoden im Vergleich (Pandoc, VSCode, Online)

Kurze Antwort vorab

Für die meisten ist /markdown-to-pdf im Browser die richtige Wahl — 5 Sekunden, keine Installation, vollständige Markdown-Spezifikation inklusive Code-Highlighting, KaTeX und Mermaid. Pandoc ist meist überdimensioniert. Die anderen drei Methoden haben gute Existenzberechtigungen, sind aber nischiger als das Internet glauben macht.

Wir haben alle fünf an einem 30-Seiten-Markdown-Report mit Codeblöcken, KaTeX-Mathe, Tabellen und einem Mermaid-Diagramm gemessen. Hier kommt das Ergebnis, der Existenzgrund jeder Methode und wo sie tatsächlich gewinnt.

Methode 1 — Online-Konverter (`/markdown-to-pdf`)

Gut für: Einmal-Konvertierung, Code-Highlighting, Mathe, Diagramme, ohne Installation.

Wie: /markdown-to-pdf öffnen, einfügen, PDF klicken.

Zeit zur ersten PDF: ~5 Sekunden.

Pro: Null Installation, läuft in jedem Browser. Volle Markdown-Spezifikation inklusive KaTeX und Mermaid. Helle und dunkle Themes. Kein Wasserzeichen für kostenlose Konten.

Contra: 1 MB Eingabe-Limit. Eine Datei pro Vorgang — für Batch-Jobs siehe Mehrere Markdown-Dateien als PDF konvertieren.

Wann verwenden: 95 % aller Einmal-Konvertierungen.

Methode 2 — Pandoc

Gut für: Wissenschaftliche Arbeiten, eigene LaTeX-Templates, Zitate und Referenzen, Multi-Format-Output (PDF + DOCX + EPUB aus einer Quelle).

Wie:

brew install pandoc
brew install --cask basictex  # oder mactex (~5 GB)
pandoc input.md -o output.pdf

Zeit zur ersten PDF: 30–90 Minuten beim ersten Mal (Pandoc + LaTeX installieren, Template-Fehler beheben). Danach 5 Sekunden.

Pro: Stabil, skriptbar, unbegrenzte Templating-Möglichkeiten via LaTeX. Zitate nativ (--bibliography). Läuft offline. Buchqualität-Typografie.

Contra: LaTeX braucht 3–5 GB. Default-Output sieht akademisch aus. Eigene Templates sind schwer. Code-Highlighting braucht --highlight-style und wirkt nach Web-Standards veraltet. Mermaid braucht ein Filter-Plugin.

Wann verwenden: Sie veröffentlichen ein Buch, eine Doktorarbeit, ein Paper mit Bibliografie oder pflegen drei oder mehr PDF-Templates unter Versionskontrolle.

Methode 3 — VSCode-Plugin „Markdown PDF“

Gut für: Wer den ganzen Tag in VSCode Markdown schreibt.

Wie: Plugin „Markdown PDF“ von yzane installieren, Datei rechtsklicken → Markdown PDF: Export (pdf).

Zeit zur ersten PDF: 10 Sekunden beim ersten Mal (Plugin lädt im Hintergrund Chromium, ~150 MB).

Pro: Ein Klick aus dem laufenden Editor. CSS über User-Settings konfigurierbar. Anständiges Default-Styling.

Contra: Erster Export langsam wegen Chromium-Download. PDF-Ästhetik nur per CSS anpassbar. KaTeX out of the box nicht enthalten — braucht ein extra Markdown+Math-Plugin. Mermaid bleibt Code, wird kein Diagramm.

Wann verwenden: Sie schreiben fünf oder mehr PDFs pro Woche und Ihr Editor ist VSCode.

Methode 4 — Browser-Druck → als PDF speichern

Gut für: Markdown, das schon im Browser gerendert ist (GitHub-README, GitLab-Wiki, gerenderte Doku-Seite).

Wie: ⌘+P oder Strg+P → „Als PDF speichern“.

Zeit zur ersten PDF: 3 Sekunden.

Pro: Schon da. Keine Installation. Funktioniert auf jedem gerenderten HTML.

Contra: Seitenumbrüche zerschneiden Tabellen und Codeblöcke unvorhersehbar. Code-Highlighting verliert in Firefox oft die Farbe. Default-Header/-Footer enthalten URL und Seitennummer und müssen meist manuell deaktiviert werden. Rendert kein KaTeX oder Mermaid, sofern die Quellseite es nicht tut.

Wann verwenden: Sie brauchen jetzt ein PDF einer bereits gerenderten Markdown-Seite und kleine Mackel stören nicht.

Methode 5 — `md-to-pdf` (npm-CLI)

Gut für: Build-Pipelines, CI/CD, automatisierte Doku.

Wie:

npm install -g md-to-pdf
md-to-pdf input.md

Zeit zur ersten PDF: 10 Sekunden (bündelt Puppeteer-Chromium, ~120 MB beim Erststart).

Pro: Skriptbar. YAML-Front-Matter für Per-Dokument-Theming. Watch-Modus. Offline nach Installation.

Contra: Node + Chromium nötig. Theming nur via YAML + CSS, weniger ausdrucksstark als Pandoc/LaTeX. Mermaid out of the box nicht — braucht ein markdown-it-Plugin.

Wann verwenden: Ihre Doku-Seite baut PDFs in CI; Sie wollen PDFs neben dem Quellcode unter Versionskontrolle.

Hinweis: Das ältere Paket markdown-pdf (ohne Bindestrich) wurde seit 2019 nicht mehr gepflegt und hat bekannte Sicherheitsadvisorys. md-to-pdf ist der gepflegte Nachfolger.

Vergleich auf einen Blick

Methode	Installation	Erste PDF	Highlighting	Mathe	Mermaid	Gut für
`/markdown-to-pdf`	0 MB	5 s	ja	ja (KaTeX)	ja	Einmalig
Pandoc	3–5 GB	30–90 min	basis	ja (LaTeX)	filter	Bücher, Paper
VSCode-Plugin	150 MB	10 s	ja	extra Plugin	nein	VSCode-Nutzer
Browser-Druck	0 MB	3 s	variiert	nein	nein	Schon gerendert
`md-to-pdf` CLI	120 MB	10 s	ja	konfig	Plugin	CI/CD

Welche sollten Sie wirklich nehmen?

Die meisten Leser → /markdown-to-pdf. Antwort für ~95 % der Fälle.
Akademiker mit Zitaten → Pandoc.
VSCode-Daily-Driver → das VSCode-Plugin.
DocOps / CI-Builds → md-to-pdf CLI.
GitHub-README jetzt sofort → Browser-Druck, mit Macken leben.

Die Versuchung bei Markdown-→-PDF-Tools ist Overengineering. Bei einem Dokument: nichts installieren. Bei tausend Dokumenten: CLI in CI automatisieren. Eine Mittellage, die Pandoc für Nicht-Akademiker rechtfertigt, gibt es selten.

Häufige Fragen

Welche Methode bewahrt Code-Highlighting am besten?

Die Headless-Chromium-Optionen (/markdown-to-pdf, VSCode-Plugin, md-to-pdf CLI). Sie rendern alle durch echtes Chromium, sodass jedes highlight.js- oder Prism-Theme übernommen wird. Pandocs --highlight-style wirkt nach Web-Standards veraltet. Tiefer: Markdown zu PDF mit Code-Highlighting.

Welche kann mehrere Dateien stapelweise konvertieren?

Die CLI kann das natürlich (md-to-pdf chapter*.md). Für das Web-Tool siehe Markdown-Dateien stapelweise zu PDF.

Warum nicht markdown-pdf statt md-to-pdf?

markdown-pdf (ohne Bindestrich) wird seit 2019 nicht mehr gepflegt und hat bekannte Sicherheitsadvisorys. md-to-pdf ist der gepflegte Nachfolger.

Gibt es eine Markdown-zu-PDF-API?

Ja — siehe unsere Markdown-to-Image-API, die einen PDF-Output-Modus zur programmatischen Erzeugung hat.

Welche Methode geht am besten mit Chinesisch / CJK-Schriften um?

/markdown-to-pdf und md-to-pdf nutzen den Browser-Font-Stack des Hosts; CJK funktioniert, wenn das System eine CJK-Schrift hat. Pandoc mit XeLaTeX braucht expliziten Font (mainfont:). Das VSCode-Plugin handhabt CJK out of the box.

Welche ist am günstigsten im Skalieren?

Für 100+ PDFs/Woche ist md-to-pdf in CI praktisch kostenlos (nur Compute). Für Gelegenheitsnutzung ist das Browser-Tool gratis. Pandoc selbst ist gratis, aber Template-Pflege kostet Engineering-Zeit.

Fazit

Der Sieger hängt vom Volumen ab. Eine PDF → Browser-Tool. Tausend PDFs → CLI in CI. Bücher mit Zitaten → Pandoc. Das Schwergewicht erst auspacken, wenn die Leichtbau-Variante schmerzt.