Markdown in VS Code als PDF exportieren
Exportiere Markdown als PDF aus dem VS-Code-Editor oder der Vorschau. Ohne Erweiterung kannst du im Browser ein PDF mit auswählbarem Text speichern.
Die integrierte Markdown-Vorschau von VS Code hat keinen Befehl für den PDF-Export. Mit der Erweiterung Markdown PDF kannst du eine .md-Datei direkt aus dem Editor exportieren, mit Markdown Preview Enhanced aus der Vorschau. Für eine einzelne Datei geht es auch ohne Erweiterung im Browser.
A. Mit Markdown PDF aus dem Editor exportieren
- Suche in der Erweiterungsansicht von VS Code nach
yzane.markdown-pdfund installiere Markdown PDF. - Öffne die
.md-Datei. MitF1oderCtrl+Shift+P(am Mac⌘⇧P) öffnest du die Befehlspalette. - Gib
exportein und wählemarkdown-pdf: Export (pdf). Per Rechtsklick in den Editor erreichst du dieselben Exportoptionen, darunter auchhtml,png,jpegundall.
Die Erweiterung rendert die Seiten mit Chromium über Puppeteer. Wenn markdown-pdf.executablePath gesetzt ist, verwendet sie den dort angegebenen Browser. Andernfalls sucht sie nach einer Installation von Chrome, Edge oder Chromium. Findet sie keine, lädt sie beim ersten Einsatz Chromium herunter. Mit markdown-pdf.chromium.autoDownload auf false schaltest du diesen Download aus.
Das voreingestellte Papierformat ist A4. Für ein Handout im Letter-Format mit rundum 1,5 cm Rand kannst du diese Einträge in deine settings.json übernehmen.
{
"markdown-pdf.format": "Letter",
"markdown-pdf.margin.top": "1.5cm",
"markdown-pdf.margin.bottom": "1.5cm",
"markdown-pdf.margin.left": "1.5cm",
"markdown-pdf.margin.right": "1.5cm"
}
Mit markdown-pdf.displayHeaderFooter blendest du Kopf- und Fußzeilen ein. Ihren Inhalt legst du mit markdown-pdf.headerTemplate und markdown-pdf.footerTemplate fest. Den Ausgabeordner bestimmst du mit markdown-pdf.outputDirectory, eigene CSS-Dateien bindest du mit markdown-pdf.styles ein. Neuere Versionen bereinigen direkt eingebetteten HTML-Code standardmäßig.
B. Aus der Vorschau von Markdown Preview Enhanced exportieren
- Installiere Chrome und die Erweiterung Markdown Preview Enhanced (
shd101wyy.markdown-preview-enhanced). - Öffne die Markdown-Datei und führe
Markdown Preview Enhanced: Open Previewaus. MitCtrl+K V(am Mac⌘K V) öffnest du die Vorschau neben dem Editor. - Klicke mit der rechten Maustaste in die Vorschau, wähle
Chrome (Puppeteer)und anschließend den PDF-Export.
Für ein Dokument in A4 im Hochformat setzt du diesen YAML-Block ganz an den Anfang der Markdown-Datei.
---
puppeteer:
landscape: false
format: "A4"
---
C. Ohne Erweiterung im Browser umwandeln
Öffne den Konverter für Markdown zu PDF von ConverterTo, wähle die Datei und stelle A4 oder Letter ein. Die Umwandlung läuft im Browser. Je nachdem, wie der Empfänger das PDF nutzen möchte, hast du zwei Möglichkeiten.
- Bildbasiertes PDF erstellen erzeugt eine Datei zum Herunterladen. Die Seitenumbrüche liegen zwischen den Zeilen. Jede Seite ist ein Bild, ihr Text lässt sich deshalb nicht markieren.
- Als PDF drucken (auswählbarer Text) öffnet den Druckdialog des Browsers. Speichere das Dokument dort als PDF, wenn der Empfänger Textstellen kopieren möchte.
Welche Methode passt?
| Merkmal | Markdown PDF | Markdown Preview Enhanced | ConverterTo |
|---|---|---|---|
| Einrichtung | Erweiterung und Chromium-basierter Browser | Erweiterung und Chrome | Konverter im Browser öffnen |
| Text auswählbar | In der Regel ja | In der Regel ja | Beim Speichern über den Druckdialog |
| Eigenes CSS | markdown-pdf.styles | Stile der Vorschau | Vorgegebene Gestaltung |
| Offline nach Einrichtung | Mit lokalen Ressourcen meist möglich | Mit lokalen Ressourcen meist möglich | Verbindung zum Laden des Konverters und externer Bilder nötig |
| Relative Bildpfade | Meist nutzbar, wenn die Dateien vorliegen | Meist nutzbar, wenn die Dateien vorliegen | Absolute Bild-URLs verwenden |
| Sinnvoll für | Wiederkehrende Exporte mit gleichen Einstellungen | Export aus der gewohnten Vorschau | Einmalige Konvertierung |
Häufige Probleme lösen
- Der Proxy blockiert den Chromium-Download. Konfiguriere
http.proxyin VS Code oder gib untermarkdown-pdf.executablePathden Pfad zu einem installierten Browser an. - Ein Bild fehlt. Prüfe einen Pfad wie
images/chart.pngausgehend vom Ordner der Markdown-Datei. Wenn du im Browser nur diese eine Datei auswählst, kann der Konverter relative Bildpfade nicht auflösen. Verwende dort eine absolute Bild-URL. Externe Bilder lädt der Browser vom jeweiligen Bildserver, der dabei deine IP-Adresse sehen kann. - Chinesische, japanische oder koreanische Zeichen erscheinen als Kästchen. Prüfe, ob auf dem Rechner, der das PDF erzeugt, eine Schrift mit den benötigten Zeichen installiert ist.
- Ein Abschnitt soll auf einer neuen Seite beginnen. Füge bei Markdown PDF vor der Überschrift eine eigene Zeile mit
<div class="page"></div>ein.
Häufig gestellte Fragen
Kann ich beim Speichern automatisch exportieren? Aktiviere in Markdown PDF die Option markdown-pdf.convertOnSave und starte VS Code neu. Für Markdown Preview Enhanced trägst du export_on_save: { puppeteer: true } auf der obersten Ebene des YAML-Blocks am Dateianfang ein.
Was eignet sich für eine Webseite oder zum Weiterbearbeiten? Mit Markdown zu HTML erhältst du eine Webseite, mit Markdown zu Word ein bearbeitbares Dokument.