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; Codefarben, KaTeX, Mermaid, Tabellen, Bilder und Aufgabenlisten werden unterstützt. Nach der Anmeldung stehen insgesamt fünf Browser-Exporte ohne Wasserzeichen bereit, danach unbegrenzt viele mit Wasserzeichen. Creator kostet 9 USD/Monat für unbegrenzte saubere Browser-Exporte; der 1-USD-Pass gilt für einen solchen Export. API-Credits sind separat.

Umfang: Die einzelne PDF-Seite begrenzt Eingaben auf 1 MB. Das separate kostenpflichtige Batch-Tool erzeugt für mehrere Dateien ein ZIP mit getrennten Ausgaben. Grenzen und gemeinsame PDFs erklärt der Batch-Leitfaden.

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

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

Contra: PDF-Engine, Schriften und Vorlagen müssen konfiguriert werden. Wähle mit --syntax-highlighting ein Syntax-Theme und prüfe die Ausgabe der gewählten Engine. Bereite Mermaid als Bilder oder über einen passenden Vorverarbeitungsschritt vor.

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).

Pro: Export aus dem Editor mit konfigurierbarem CSS und Codefarben. Die aktuelle README dokumentiert Mermaid und KaTeX; prüfe installierte Version und Konfiguration.

Contra: Die Erweiterung benötigt eine kompatible Browser-Laufzeit; Einstellungen und CSS bestimmen das Ergebnis. Editor-Vorschauerweiterungen sind nicht automatisch Teil des PDF-Exports. Prüfe Formeln, Mermaid, Schriften und Umbrüche in der PDF.

Wann nutzen: Du schreibst und prüfst die Quelle bereits in VS Code und möchtest dort auch den Export konfigurieren.

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“.

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

Contra: Die Ausgabe hängt vom Druck-CSS der Seite und den Druckeinstellungen ab. Prüfe Hintergründe, Codefarben, Kopf- und Fußzeilen sowie Umbrüche. Formeln und Diagramme müssen bereits auf der Seite gerendert sein.

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

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

Contra: Node.js und Browser-Laufzeit sind erforderlich. Anpassungen erfolgen über Konfiguration und CSS. Prüfe benötigte Markdown-Erweiterungen; nicht gerenderte Diagramme vorab als Bild vorbereiten.

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

Verwende den Paketnamen aus der verlinkten Dokumentation. md-to-pdf und markdown-pdf sind verschiedene Pakete; prüfe vor der Installation Release und Sicherheitshinweise.

• 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.

Automation passt für regelmäßige oder commitgesteuerte Builds. Für gelegentliche Dateigruppen vermeidet Browser-Batch lokale Einrichtung. Pandoc passt zu einem geordneten Dokument mit Publikationsstruktur, Zitaten und kontrollierter Vorlage.

Welche Methode bewahrt Code-Highlighting am besten?

Chromium-Methoden können Web-Highlighting mit passenden Theme- und Druckeinstellungen erhalten. Pandoc nutzt eigene Syntax-Themes. Vergleiche dieselbe Codevorlage, statt unveränderte Übernahme anzunehmen. Mehr im Highlighting-Leitfaden.

Welche kann mehrere Dateien stapelweise konvertieren?

Für mehrere Dateien bietet Batch export einen kostenpflichtigen Browser-Weg: bis zu 15 Markdown-Dateien pro Lauf, ein ZIP mit einer Ausgabe je Eingabe. Creator enthält 20 Läufe pro Monat. PDF erzeugt getrennte PDFs; für ein gemeinsames Dokument eignet sich Pandoc.

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

Dieser Leitfaden nutzt das oben verlinkte md-to-pdf. Paketnamen sind nicht austauschbar; prüfe bei Alternativen Dokumentation, Releases und Sicherheitshinweise.

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?

Vergleiche die Gesamtkosten: Browser-Tarif, gegebenenfalls API-Credits, CI-Rechenzeit, Schriften und Vorlagenpflege. Creator für den Browser enthält keine API-Render-Credits. Entscheide anhand der tatsächlichen Nutzung.

Wähle nach Ergebnis: ein Dokument im Browser, ein ZIP aus dem Browser-Batch, wiederkehrende CI-Builds oder ein gemeinsames Dokument mit Literaturangaben über Pandoc. Vergleiche dieselbe Vorlage in den tatsächlichen PDFs.

# Document export test

## Handoff checklist
- [x] Headings
- [x] Table layout
- [x] Code formatting

| Check | Expected result |
|:--|:--|
| Body text | Readable at page width |
| Links | Retained in PDF |

> Demo content for comparing export methods.

Beispiel-PDF herunterladen

Nutze dieses Beispiel in allen geprüften Methoden. Der gezeigte Export ist ein Produktbeispiel, kein gemessener Vergleich aller fünf Tools. Prüfe Tabellenränder, Aufgabenmarkierungen und Textauswahl in jeder PDF.

Produktgrenzen und Befehle wurden anhand dieser aktuellen Primärquellen geprüft:

• https://markdowntoimage.com/markdown-to-pdf
• https://pandoc.org/MANUAL.html
• https://github.com/yzane/vscode-markdown-pdf
• https://github.com/simonhaenisch/md-to-pdf

Öffne MarkdownToImage, rendere Markdown und wähle das passende Ausgabeformat. Vor einem Batch zuerst ein repräsentatives Dokument testen.

Dokument im PDF-Konverter testen.

• PDF-Export im Browser vorbereiten
• Codefarben in PDF erhalten