Un EPUB è uno zip di pagine web con un indice, e un file Markdown ha già fatto gran parte della strada.
Un lettore costruisce l’indice e il pulsante «capitolo successivo» da file separati, non dai titoli: una sola pagina lunga è un libro senza capitoli, per quanto ben titolata. Un libro vuole anche le immagini al suo interno — la maggior parte dei lettori non ne scarica dal web —, un manifesto che nomini ogni file, e un titolo e una lingua, che il lettore usa per la sillabazione e la lettura ad alta voce.
Dai titoli che si ripetono. Due o più titoli `#` di primo livello danno un capitolo ciascuno; un titolo `#` sopra diverse sezioni `##` dà un capitolo per sezione, con il titolo ad aprire il primo. Un documento senza né l’uno né l’altro è un solo capitolo, che è ciò che era.
Apple Books, Google Play Books, Kobo, Calibre e Thorium aprono un EPUB direttamente, e Send to Kindle lo accetta dal 2022. Per controllare un libro prima di mandarlo da qualche parte, aprilo in Calibre o passalo a EPUBCheck, il validatore che usano gli stessi store.
Prima l’indice: ogni capitolo dovrebbe portare il nome del suo titolo. Poi ogni pagina con una formula o un diagramma: viaggiano come MathML e SVG, che tutti i lettori attuali mostrano e alcuni vecchi modelli a inchiostro elettronico no.