Markdown in PDF umwandeln, ohne dass das Layout verloren geht (2026)

Du hast ein sauberes Markdown-Dokument geschrieben. Du klickst auf „Als PDF exportieren“. Plötzlich brechen Codeblöcke falsch um, Tabellen laufen über den Rand und ein Absatz ist mitten durchgeschnitten.

Diese Anleitung zeigt, wie du Markdown in PDF umwandelst, ohne Formatierung zu verlieren — inklusive Code, Tabellen, Bilder, Links und Seitenumbrüche — mit kostenlosem Online-Konverter, VS Code und Pandoc.

Warum Markdown → PDF das Layout versaut

Markdown ist Klartext; PDF ist eine feste Seite. Die meisten Fehler kommen aus vier Lücken:

Problem	Im PDF	Ursache
Codeblöcke abgeschnitten	Zeilen am Seitenrand weg	Keine Seitenumbruch-Steuerung
Tabellen beschnitten	Spalten fehlen rechts	Seitenbreite zu klein
Schrift ändert sich	Serifen, seltsame Größen	Fehlende Schriftzuordnung
Letzte Seite leer	Leere Endseite	Anhängende Umbrüche / Ränder

Behoben? Dann sieht das PDF aus wie die Vorschau.

Methode 1: Kostenloser Online-Konverter (am schnellsten)

Wenn du mit einem Klick ohne Installation exportieren willst:

1. Öffne den Markdown → PDF-Konverter
2. Füge dein Markdown ein (oder lade eine .md-Datei hoch)
3. Wähle eine Vorlage (Classic, Modern, Academic …)
4. Klicke auf PDF herunterladen

Was erhalten bleibt:

• Überschriften und Abstände
• Fett, kursiv, Inline-Code
• Codeblöcke mit Syntaxhervorhebung
• Tabellen, Listen, Zitate
• Bilder und Links

Tipp: Wähle die Vorlage vor dem Export. Akademische Vorlagen haben engere Ränder und eine bessere Überschriftenhierarchie für den Druck.

Methode 2: VS Code (beste für Docs im Repo)

1. Installiere Markdown PDF
2. Öffne die .md-Datei
3. Cmd/Ctrl+Shift+P → Markdown PDF: Export (pdf)
4. Neben der Quelldatei speichern

Die Vorschau entspricht ungefähr GitHub-flavored Markdown.

Methode 3: Pandoc (beste für Stapel / CI)

pandoc README.md -o README.pdf --pdf-engine=xelatex

Nützliche Flags:

pandoc doc.md -o doc.pdf --wrap=pre --highlight-style=tango
pandoc doc.md -o doc.pdf -V geometry:margin=1in -V papersize:a4

Pandoc braucht eine LaTeX-Engine. Für gelegentliche Exporte reicht der Online-Konverter.

Diese 6 Details unbedingt behalten

1. Codeblöcke

```python
def hello():
    print("Hello, PDF!")
```

• Immer einen Sprachtag setzen
• Sehr lange Zeilen möglichst umbrechen
• Lange Zeilen dürfen nicht abgeschnitten werden

2. Tabellen

Kurze Kopfzeilen. Breite Tabellen sind die häufigste Ursache für beschnittene Spalten:

| Format | Gut für        | Editierbar? |
|--------|----------------|-------------|
| Markdown | Schreiben    | Ja          |
| PDF    | Teilen/Drucken | Nein        |
| DOCX   | Review         | Ja          |

3. Seitenumbrüche

<div style="page-break-after: always;"></div>

Vor großen Kapiteln einfügen.

4. Bilder

• Relativpfade (./images/chart.png) oder HTTPS
• PNG/JPEG unter ca. 1–2 MB
• Alt-Text setzen

5. Links

[Markdown-Syntax-Guide](/blog/markdown-syntax-guide)

6. Überschriftenhierarchie

Ein # für den Titel, dann ## / ###.

Checkliste vor dem Export

• Nur ein #-Titel
• Codeblöcke mit Fence + Sprache
• Tabellen passen auf eine Hochformatseite
• Bilder in der Vorschau sichtbar
• Kein HTML-Müll im Text

FAQ

Wie konvertiere ich Markdown kostenlos nach PDF?

In einen Online-Markdown-zu-PDF-Tool einfügen und herunterladen. Ohne Anmeldung, ohne Wasserzeichen — alles im Browser.

Warum werden Codeblöcke im PDF abgeschnitten?

Lange Zeilen plus fehlende Seitenumbruch-Steuerung. Fences nutzen, Zeilen umbrechen, Tool wählen, das Blöcke nicht mitten durchschneidet.

Bleibt Syntaxhervorhebung im PDF?

Ja — mit Konvertern, die zuerst HTML mit Highlighting rendern und dann ins PDF setzen.

PDF oder Word?

PDF für finale Weitergabe/Druck. Word, wenn noch jemand editieren muss. Siehe Markdown vs HTML vs LaTeX.

Nächste Schritte

1. Testexport: Markdown → PDF
2. Weiterbearbeiten: Markdown → Word
3. Syntax: Markdown-Syntax-Guide
4. Nachschlagen: Markdown Cheat Sheet