Zuletzt aktualisiert: 11. November 2026
Am schnellsten wandeln Sie Markdown mit Pandoc in EPUB um: Führen Sie pandoc book.md -o book.epub aus, und Sie erhalten ein gültiges EPUB. Wenn Sie nichts installieren möchten, laden Sie die .md-Datei bei einem Web-Konverter wie Convert2EPUB hoch. So oder so hängt die Qualität des E-Books vor allem davon ab, wie Sie Überschriften und Metadaten vor der Umwandlung strukturieren.
Was brauchen Sie, um eine Markdown-Datei in EPUB umzuwandeln?
Sie brauchen eine Markdown-Datei mit klarer Überschriftenstruktur, einen Titel und einen Autor sowie ein Tool, das EPUB schreibt. Pandoc ist das Standardwerkzeug für die Kommandozeile. Ein Browser-Konverter erledigt dieselbe Aufgabe ohne Installation.
Stellen Sie vor der Umwandlung sicher, dass die Quelle bereit ist:
- Eine
#-Überschrift pro Kapitel. Laut dem Benutzerhandbuch von Pandoc teilt Pandoc ein EPUB standardmäßig an Überschriften der ersten Ebene in Kapitel auf. Wenn Sie Kapitel als##schreiben, ändern Sie das oder legen Sie die Teilungsebene fest (mehr dazu unten). - Titel und Autor in einem Metadatenblock am Anfang der Datei, nicht nur in einer Überschrift.
- Bilder mit relativen Pfaden, die von dem Ordner aus funktionieren, in dem Sie den Befehl ausführen, dazu Alternativtext.
- Kein rohes HTML, auf das Sie nicht verzichten können. Einfache Tags überstehen die Umwandlung meist, aber Skripte, iframes und CSS-Tricks haben in einer Datei für den E-Reader nichts zu suchen.
Wie wandle ich Markdown mit Pandoc in EPUB um?
Installieren Sie Pandoc, setzen Sie einen YAML-Metadatenblock an den Anfang Ihrer Datei und führen Sie einen einzigen Befehl aus. Pandoc erstellt das Inhaltsverzeichnis aus Ihren Überschriften.
1. Metadaten hinzufügen
Pandoc liest die EPUB-Metadaten aus einem YAML-Block in der Markdown-Datei oder aus einer separaten YAML-Datei, wie das Pandoc-Handbuch beschreibt. Ein minimaler Block:
---
title: The Lighthouse Letters
author: Dana Whitfield
lang: en-GB
date: 2026-11-11
cover-image: cover.jpg
---
lang ist wichtiger, als viele denken. Es steuert auf manchen E-Readern die Silbentrennung und die Sprachausgabe. Das Datum wählen Sie selbst, tragen Sie also das Veröffentlichungsdatum ein, das angezeigt werden soll.
2. Den Befehl ausführen
pandoc book.md -o book.epub --toc --toc-depth=2
--toc-depthlegt fest, wie viele Überschriftenebenen im Inhaltsverzeichnis erscheinen. Laut Pandoc-Handbuch ist der Standardwert 3, aufgeführt werden also die Ebenen 1, 2 und 3. Für einen Roman ist1oder2meist übersichtlicher.--epub-cover-image=cover.jpgerfüllt denselben Zweck wie das Feldcover-image. Pandoc empfiehlt ein Cover mit weniger als 1.000 Pixeln Breite und Höhe.--epub-title-page=falseentfernt die erzeugte Titelseite, wenn Sie eine eigene geschrieben haben.
3. Mehrere Dateien zusammenführen
Viele Autorinnen und Autoren legen pro Kapitel eine eigene Datei an. Übergeben Sie die Dateien in der richtigen Reihenfolge, und Pandoc fügt sie zusammen:
pandoc 01-intro.md 02-first-night.md 03-storm.md -o book.epub
Beginnen Sie die Dateinamen mit Nummern, damit die Sortierung der Shell der Lesereihenfolge entspricht. Setzen Sie den Metadatenblock nur in die erste Datei.
4. Zurückhaltend gestalten
Pandoc wendet ein Standard-Stylesheet an. Um es zu ändern, übergeben Sie --css=epub.css. Halten Sie das CSS minimal: Legen Sie Absatzeinzüge und Abstände um Überschriften fest und lassen Sie Schriftart und Schriftgröße in Ruhe. E-Reader lassen die Leser beides selbst wählen, und wer es überschreibt, nimmt ihnen diese Kontrolle.
Wie strukturiere ich Überschriften, damit Kapitel und Inhaltsverzeichnis stimmen?
Verwenden Sie # für Kapitel und ## für Abschnitte darin, und überspringen Sie keine Ebenen. Das Navigationsmenü des EPUB wird aus diesen Überschriften erzeugt: Die Struktur, die Sie schreiben, ist die Struktur, die Ihre Leser bekommen.
| Ihr Markdown | Was im EPUB passiert (Pandoc-Standardeinstellungen) |
|---|---|
# Chapter | Beginnt eine neue Kapiteldatei und erscheint im Inhaltsverzeichnis |
## Section | Erscheint im Inhaltsverzeichnis (standardmäßig Tiefe 3), bleibt aber in der Kapiteldatei |
### Subsection | Erscheint im Inhaltsverzeichnis nur, wenn die Tiefe es zulässt |
| Fett gesetzter Text, der wie eine Überschrift aussieht | Keine Überschrift; erscheint nicht im Inhaltsverzeichnis |
Zwei häufige Probleme:
- Ein Buch mit nur einer
#-Überschrift. Das ganze Buch wird zu einer einzigen großen Datei. Das Pandoc-Handbuch merkt an, dass diese Option nur den inneren Aufbau des EPUB betrifft, nicht die Art, wie Kapitel den Lesern angezeigt werden, und dass manche E-Reader bei sehr großen Kapiteldateien langsam sein können. Für ein langes Dokument mit wenigen Überschriften der obersten Ebene verwenden Sie--split-level=2oder3. - Ein Titel als
#und Kapitel ebenfalls als#. Der Titel erscheint dann als Kapitel. Setzen Sie den Titel in den YAML-Block und reservieren Sie#für echte Kapitel.
Wenn Ihr Inhaltsverzeichnis danach immer noch falsch aussieht, führt Sie unser Ratgeber zum Beheben eines fehlenden oder fehlerhaften EPUB-Inhaltsverzeichnisses durch die Prüfungen.
Lässt sich Markdown auch ohne Pandoc-Installation in EPUB umwandeln?
Ja. Bei einem Web-Konverter, der .md-Dateien annimmt, laden Sie die Datei hoch, legen Titel und Autor fest und laden das EPUB herunter. Das eignet sich für einmalige Umwandlungen und für alle, die keine Kommandozeile nutzen möchten.
So schneiden die beiden Ansätze im Vergleich ab:
| Pandoc | Browser-Konverter | |
|---|---|---|
| Installation nötig | Ja | Nein |
| Wiederholbar in einem Build-Skript oder in CI | Ja | Nein |
| Eigenes CSS, eigene Schriften, Filter | Volle Kontrolle | Beschränkt auf die Einstellungen des Tools |
| Mehrere Dateien zusammenführen | Ja, durch Auflisten | Vorher zu einer Datei zusammenfassen |
| Am besten für | Bücher, die Sie oft neu erstellen | Schnelle, gelegentliche Umwandlungen |
Das Upload-Feld von Convert2EPUB führt Markdown unter den akzeptierten Formaten auf, mit einem Limit von 100 MB. Es gibt Einstellungen für Titel, Autor, umfließendes oder festes Layout und Zielgerät. Das kostenlose Standard-Modell wird auf der Website als gut geeignet für einfache Layouts wie Romane beschrieben, und genau das sind auch die meisten Markdown-Manuskripte. Wenn Sie unsicher sind, ob umfließend die richtige Wahl ist, lesen Sie unseren Vergleich Umfließend oder festes Layout im EPUB. Für Prosa ist es das.
Was sollte ich prüfen, bevor ich das EPUB auf einen E-Reader schicke?
Öffnen Sie die Datei in mindestens einer echten Lese-App und gehen Sie eine kurze Checkliste durch. Die meisten Probleme bei der Umwandlung von Markdown in EPUB sind in den ersten fünf Minuten zu sehen.
- Inhaltsverzeichnis: Öffnen Sie das Navigationsmenü. Jedes Kapitel sollte vorhanden sein, in der richtigen Reihenfolge und mit sinnvollen Namen.
- Cover und Titel: Das Cover sollte in Ihrer Bibliotheksansicht erscheinen, und Titel und Autor sollten korrekt angezeigt werden.
- Bilder: Prüfen Sie, ob jedes Bild erscheint, sich an den Bildschirm anpasst und keinen störenden Rahmen hat.
- Codeblöcke und Tabellen: Lange Zeilen in Codeblöcken können auf kleinen E-Readern über den Bildschirmrand hinauslaufen. Brechen Sie sie um oder kürzen Sie sie. Breite Tabellen schreiben Sie für einen 6-Zoll-Bildschirm besser als Listen um.
- Fußnoten: Pandoc macht aus Markdown-Fußnoten verlinkte Anmerkungen. Tippen Sie eine an und vergewissern Sie sich, dass Sie wieder zurückkommen.
- Validierung: Wenn Sie über einen Shop veröffentlichen möchten, prüfen Sie die Datei mit EPUBCheck, dem vom W3C getragenen Validator, den Shops häufig verwenden. Er findet Probleme, über die E-Reader stillschweigend hinwegsehen.
Für kleine E-Ink-Bildschirme behandelt unser Artikel EPUB-Einstellungen für einen 6-Zoll-E-Ink-Reader, was Sie in der Datei und was Sie am Gerät einstellen.
Wenn Sie sich die Einrichtung lieber sparen, können Sie Ihre .md-Datei bei Convert2EPUB hochladen und ein umfließendes EPUB herunterladen.
Kann ich ein aus Markdown erstelltes EPUB auf einem Kindle lesen?
Ja. Senden Sie das EPUB per E-Mail oder über die App „Send to Kindle“ an Ihren Kindle, eine Umwandlung in MOBI oder AZW3 brauchen Sie nicht. Laut der eigenen Seite von Convert2EPUB nimmt „Send to Kindle“ ein EPUB unverändert an. Unser Ratgeber zum Senden eines EPUB an Ihren Kindle zeigt die einzelnen Schritte.
Häufig gestellte Fragen
Kann Pandoc Markdown direkt in MOBI oder AZW3 umwandeln?
Nein. Pandoc schreibt EPUB, nicht MOBI oder AZW3. Aktuelle Wege auf den Kindle nehmen EPUB direkt an, eine separate Umwandlung ist also meist unnötig. Nur sehr alte Kindles brauchen MOBI.
Warum ist mein EPUB ein einziges riesiges Kapitel?
Pandoc teilt Kapitel standardmäßig an Überschriften der ersten Ebene. Hat Ihr Markdown nur ein # oder gar keines, landet alles in einer Datei. Machen Sie Ihre Kapitelüberschriften zu #, oder setzen Sie --split-level=2.
Wie füge ich ein Coverbild hinzu?
Fügen Sie cover-image: cover.jpg in den YAML-Block ein, oder übergeben Sie --epub-cover-image=cover.jpg. Das Pandoc-Handbuch empfiehlt ein Bild mit weniger als 1.000 Pixeln Breite und Höhe. Geben Sie den Pfad relativ zu dem Ordner an, in dem Sie den Befehl ausführen.
Bleiben Markdown-Formatierungen wie Fettdruck, Listen und Blockzitate erhalten?
Ja. Standardelemente von Markdown werden im EPUB zu ihren HTML-Entsprechungen, und die eigene Gestaltung des E-Readers stellt sie dar. Erweiterungen unterscheiden sich je nach Tool, prüfen Sie also ungewöhnliche Syntax wie Definitionslisten oder Aufgabenlisten in der Ausgabe.
Kann ich einen ganzen Ordner mit Markdown-Dateien umwandeln?
Mit Pandoc ja. Listen Sie die Dateien in der richtigen Reihenfolge auf oder verwenden Sie ein Platzhaltermuster wie *.md, wie es eine Anleitung in der DEV Community mit einem Dokumentations-Repository vorführt. Nummerieren Sie Ihre Dateinamen, damit die Reihenfolge vorhersehbar ist.
Bereit, Ihr eigenes PDF umzuwandeln? Für normale Textdokumente ist es kostenlos, ohne Konto.
PDF in EPUB umwandeln →