Markdown ist ideal zum Schreiben, doch die Empfänger eines Dokuments erwarten oft eine Webseite oder ein PDF. Die gute Nachricht: Markdown umzuwandeln ist einfach, und in den meisten Fällen brauchen Sie dafür keine komplizierte Toolchain.
Im Folgenden finden Sie vier Wege – vom schnellsten bis zum am besten konfigurierbaren – und eine Reihe von Tipps für ein professionelles Ergebnis.
Schneller Vergleich
| Methode | HTML | Installation | Ideal für | |
|---|---|---|---|---|
| Export aus einem Browser-Editor | ✅ | ✅ (Drucken) | Nichts | Alltägliche Dokumente, schnelles Teilen |
| VS Code + Erweiterung | ✅ | ✅ | Editor + Erweiterung | Wer ohnehin in VS Code schreibt |
| Pandoc | ✅ | ✅ | Pandoc (+ PDF-Engine) | Bücher, wissenschaftliche Arbeiten, automatisierte Pipelines |
| Ein Skript (markdown-it, marked) | ✅ | — | Node.js | Eigene Websites und Build-Schritte |
1. Export aus einem Browser-Editor
Am schnellsten geht es mit einem Editor, der direkt exportiert. Öffnen oder fügen Sie Ihr Dokument im Markdown Preview Editor ein – in der Online-Version oder Ihrer eigenen Kopie – und nutzen Sie die Schaltflächen in der Kopfleiste:
- HTML erzeugt eine einzelne, eigenständige
.html-Datei. Styles, Codehervorhebung, Formeln, Diagramme und die zusammen mit dem Dokument geöffneten Bilder werden eingebettet. So sieht die Datei auf jedem Computer richtig aus und lässt sich unverändert per E-Mail verschicken oder irgendwo hochladen. - Drucken öffnet den Druckdialog des Browsers. Wählen Sie als Ziel Als PDF speichern, um ein PDF zu erhalten. Gedruckt wird nur das dargestellte Dokument – ohne Werkzeugleiste, ohne Editor.
- Speichern lädt den Markdown-Quelltext als
.md-Datei herunter.
Da alles im Browser passiert, funktioniert das auch mit Dokumenten, die Sie lieber nicht bei einem Online-Konverter hochladen möchten.
Ein sauberes PDF aus dem Druckdialog
- Stellen Sie die Ränder auf Standard oder Minimum – je nachdem, wie viel Text auf eine Seite passen soll.
- Schalten Sie Kopf- und Fußzeilen aus, um Datum und URL an den Seitenrändern zu entfernen.
- Schalten Sie Hintergrundgrafiken ein, wenn Sie Hintergründe von Codeblöcken und Tabellenstreifen behalten möchten.
- Verwenden Sie zum Drucken ein helles Design – das spart Tinte und ist auf Papier besser lesbar.
2. VS Code mit einer Erweiterung
VS Code hat eine eingebaute Markdown-Vorschau, aber keinen Export-Button. Erweiterungen wie Markdown PDF oder Markdown Preview Enhanced ergänzen Befehle zum Export als HTML und PDF. Das ist praktisch, wenn VS Code ohnehin Ihr Editor ist; das Aussehen der Ausgabe hängt von der Erweiterung ab, und manche laden beim ersten Einsatz einen Headless-Browser herunter.
3. Pandoc – der universelle Konverter
Pandoc konvertiert zwischen Dutzenden Formaten und ist das Standardwerkzeug für Bücher, wissenschaftliche Arbeiten und automatisierte Dokumentation. Nach der Installation genügt ein einziger Befehl:
bash# Markdown in eine vollständige HTML-Seite
pandoc report.md -o report.html --standalone --metadata title="Report"
# Markdown in PDF (benötigt eine PDF-Engine, z. B. eine LaTeX-Distribution)
pandoc report.md -o report.pdf --pdf-engine=xelatex
# Markdown in Word, falls jemand darauf besteht
pandoc report.md -o report.docx
Ohne --standalone gibt Pandoc nur ein HTML-Fragment aus – praktisch, wenn Sie es in eine bestehende Seite einfügen. Für PDF-Ausgabe ist eine separate Engine nötig: eine LaTeX-Distribution oder eine HTML-basierte Engine wie WeasyPrint. Die Stärke von Pandoc ist die Kontrolle: Vorlagen, Zitate, nummerierte Abschnitte und Querverweise.
4. Ein paar Zeilen JavaScript
Ist Markdown Teil Ihrer eigenen Website oder Ihres Build-Prozesses, ist eine Bibliothek die flexibelste Option. Mit markdown-it:
jsimport MarkdownIt from 'markdown-it';
import { readFileSync, writeFileSync } from 'node:fs';
const md = new MarkdownIt({ linkify: true, typographer: true });
const body = md.render(readFileSync('README.md', 'utf8'));
writeFileSync('README.html', `<!doctype html><meta charset="utf-8"><title>README</title>${body}`);
Plugins ergänzen Fußnoten, Aufgabenlisten, Formeln und mehr. Denken Sie daran: Die Ausgabe ist nur so sicher wie die Eingabe. Stammt das Markdown von anderen Personen, bereinigen Sie das HTML (zum Beispiel mit DOMPurify), bevor Sie es veröffentlichen.
Tipps für bessere HTML- und PDF-Ausgabe
Mit einem klaren Titel beginnen
Konverter übernehmen den Dokumenttitel aus dem Dateinamen, der ersten Überschrift oder expliziten Metadaten. Geben Sie jedem Dokument einen aussagekräftigen Dateinamen und eine einzige #-Überschrift – dann sind das exportierte HTML und PDF im Download-Ordner oder im Browser-Tab leicht zu erkennen.
Bilder neben dem Dokument ablegen
Verwenden Sie relative Pfade wie images/chart.png und legen Sie die Dateien im selben Ordner ab. Wenn Sie den ganzen Ordner im Markdown Preview Editor öffnen, werden die Bilder aufgelöst und in den HTML-Export eingebettet. Externe Bilder, die in der Vorschau nicht geladen werden, werden auch nicht eingebettet.
Seitenumbrüche steuern
Markdown hat keine Syntax für Seitenumbrüche. Beginnen Sie in Druckdokumenten große Abschnitte mit einer ##-Überschrift und halten Sie Tabellen kurz – Browser vermeiden es, Tabellenzeilen zu teilen, aber eine riesige Tabelle läuft trotzdem auf der nächsten Seite weiter. In Werkzeugen, die rohes HTML und Inline-Styles erlauben, etwa Pandoc, können Sie <div style="page-break-after: always"></div> einfügen.
Formeln und Diagramme vor dem Export prüfen
Formeln und Diagramme werden in den meisten Werkzeugen von JavaScript-Bibliotheken dargestellt. Prüfen Sie sie zuerst in der Vorschau – siehe unsere Anleitungen zu mathematischen Formeln in Markdown und Mermaid-Diagrammen. Im HTML-Export des Markdown Preview Editor werden sie als fertiges Markup und Bilder gespeichert, sodass die exportierte Datei keine Skripte benötigt.
Das Design bewusst wählen
Dunkle HTML-Exporte sind am Bildschirm angenehm, für Papier aber eine schlechte Wahl. Exportieren Sie für das Medium, das Ihre Leser nutzen.
Häufig gestellte Fragen
Wie wandle ich Markdown kostenlos in PDF um?
Öffnen Sie das Dokument in einer Markdown-Vorschau wie dem Markdown Preview Editor, klicken Sie auf Drucken und wählen Sie im Druckdialog Als PDF speichern. Für automatisierte Ausgabe oder Bücher nutzen Sie das kostenlose Kommandozeilenwerkzeug Pandoc.
Wie wandle ich Markdown in HTML um, ohne etwas zu installieren?
Nutzen Sie einen Browser-Editor mit HTML-Export. Der Markdown Preview Editor erstellt direkt in Ihrem Browser eine eigenständige HTML-Datei mit allen Styles.
Werden Bilder in das exportierte HTML übernommen?
Lokale Bilder, die Sie zusammen mit dem Dokument geöffnet haben, werden in die HTML-Datei eingebettet, sodass sie für sich allein funktioniert. Bilder, die auf externen Servern bleiben, werden nicht eingebettet.
Kann ich Markdown in Word (DOCX) umwandeln?
Ja, mit Pandoc: pandoc input.md -o output.docx. Alternativ exportieren Sie HTML und öffnen es in Word – der Großteil der Formatierung bleibt dabei erhalten.