5 Methoden, Markdown in PDF zu konvertieren — im Vergleich (Pandoc, VSCode, Online-Tools)
Für ein einzelnes Dokument hat /markdown-to-pdf im Browser den geringsten Setup-Aufwand. Pandoc passt besser zu Zitaten und Publishing-Pipelines; VS Code und CLI zu Editor- oder Automationsabläufen. Entscheidend sind Funktionen, Reproduzierbarkeit und lokale Kontrolle.
Der Vergleich basiert auf aktuell dokumentierten Funktionen statt festen Stoppuhr- oder Downloadgrößen, da Setup-Zeit und Browser-Runtime je nach System und Version variieren.
Gut für: Einmal-Konvertierung, Code-Highlighting, Mathe, Diagramme, ohne Installation.
Wie: /markdown-to-pdf öffnen, einfügen, PDF klicken.
Setup und erster Lauf: Variiert nach Betriebssystem, PDF-Engine, Cache und Dokumentkomplexität; in der eigenen Umgebung testen.
Pro: Keine lokale Installation, im Browser nutzbar. Rendert Code-Highlighting, KaTeX, Mermaid, Tabellen, Bilder und Task-Listen. Gratis-Ausgaben tragen ein Wasserzeichen; angemeldete Gratisnutzer erhalten derzeit insgesamt fünf wasserzeichenfreie Exporte.
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.
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 # or mactex (platform-dependent)
pandoc input.md -o output.pdf
Setup und erster Lauf: Variiert nach Betriebssystem, PDF-Engine, Cache und Dokumentkomplexität; in der eigenen Umgebung testen.
Pro: Stabil, skriptbar, unbegrenzte Templating-Möglichkeiten via LaTeX. Zitate nativ (--bibliography). Läuft offline. Buchqualität-Typografie.
Contra: LaTeX braucht plattformabhängig. Default-Output sieht akademisch aus. Eigene Templates sind schwer. Code-Highlighting braucht --syntax-highlighting 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.
Gut für: Wer den ganzen Tag in VSCode Markdown schreibt.
Wie: Plugin „Markdown PDF“ von yzane installieren, Datei rechtsklicken → Markdown PDF: Export (pdf).
Setup und erster Lauf: Variiert nach Betriebssystem, PDF-Engine, Cache und Dokumentkomplexität; in der eigenen Umgebung testen.
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.
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“.
Setup und erster Lauf: Variiert nach Betriebssystem, PDF-Engine, Cache und Dokumentkomplexität; in der eigenen Umgebung testen.
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.
Gut für: Build-Pipelines, CI/CD, automatisierte Doku.
Wie:
npm install -g md-to-pdf
md-to-pdf input.md
Setup und erster Lauf: Variiert nach Betriebssystem, PDF-Engine, Cache und Dokumentkomplexität; in der eigenen Umgebung testen.
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.
| Methode | Installation | Erste PDF | Highlighting | Mathe | Mermaid | Gut für |
|---|---|---|---|---|---|---|
/markdown-to-pdf | None | Browser request | yes | yes (KaTeX) | yes | One-offs |
| Pandoc | Pandoc + PDF engine | Setup-dependent | yes | yes | filter | Books, papers |
| VS Code Markdown PDF | Extension + renderer | Setup-dependent | yes | extension-dependent | no | Editor users |
| Browser print | None | Browser request | varies | source-dependent | source-dependent | Rendered pages |
md-to-pdf CLI | Node.js + browser runtime | Setup-dependent | yes | configurable | plugin | CI/CD |
- 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-pdfCLI. - 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.
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 --syntax-highlighting 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.
Welche Methode geht am besten mit Chinesisch / CJK-Schriften um?
Der gehostete /markdown-to-pdf-Renderer nutzt seine serverseitige Schriftumgebung. Lokale Chromium-Tools nutzen die Fonts ihrer Runtime; Pandoc mit XeLaTeX benötigt meist eine explizite CJK-Schrift wie mainfont:. Die echten Zeichen immer testen.
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.
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.
Produktgrenzen und Befehle wurden anhand dieser aktuellen Primärquellen geprüft:
Öffne MarkdownToImage, rendere Markdown und wähle das passende Ausgabeformat. Vor einem Batch zuerst ein repräsentatives Dokument testen.