Ein EPUB ist ein Zip aus Webseiten mit Inhaltsverzeichnis, und eine Markdown-Datei ist schon fast dort.
Ein Reader baut sein Inhaltsverzeichnis und seine Schaltfläche „nächstes Kapitel“ aus einzelnen Dateien, nicht aus Überschriften — eine lange Seite ist also ein Buch ohne Kapitel, so gut sie auch gegliedert ist. Ein Buch will außerdem seine Bilder in sich tragen — die meisten Reader laden keines aus dem Netz —, ein Manifest, das jede Datei nennt, sowie Titel und Sprache, nach denen der Reader trennt und vorliest.
Aus den Überschriften, die sich wiederholen. Zwei oder mehr `#`-Überschriften der obersten Ebene ergeben je ein Kapitel; ein `#`-Titel über mehreren `##`-Abschnitten ergibt ein Kapitel pro Abschnitt, und der Titel eröffnet das erste. Ein Dokument mit keinem von beiden ist ein Kapitel — was es ja auch war.
Apple Books, Google Play Books, Kobo, Calibre und Thorium öffnen ein EPUB direkt, und „Send to Kindle“ nimmt es seit 2022 an. Wer ein Buch prüfen will, bevor es irgendwohin geht, öffnet es in Calibre oder lässt EPUBCheck darüberlaufen, den Validator, den die Shops selbst verwenden.
Zuerst das Inhaltsverzeichnis: Jedes Kapitel sollte den Namen seiner Überschrift tragen. Dann jede Seite mit Formel oder Diagramm — beide reisen als MathML und SVG, die jeder aktuelle Reader darstellt, manche älteren E-Ink-Geräte aber nicht.