Un EPUB es un zip de páginas web con un índice, y un archivo Markdown ya ha recorrido la mayor parte del camino.
Un lector construye su índice y su botón de «capítulo siguiente» a partir de archivos separados, no de encabezados, así que una sola página larga es un libro sin capítulos por bien titulada que esté. Un libro también quiere sus imágenes dentro —la mayoría de los lectores no las descargan de la web—, un manifiesto que nombre cada archivo, y un título y un idioma, que el lector usa para separar sílabas y leer en voz alta.
De los encabezados que se repiten. Dos o más encabezados `#` de primer nivel dan un capítulo cada uno; un título `#` sobre varias secciones `##` da un capítulo por sección, y el título abre el primero. Un documento sin ninguna de las dos cosas es un solo capítulo, que es lo que era.
Apple Books, Google Play Books, Kobo, Calibre y Thorium abren un EPUB directamente, y Send to Kindle lo acepta desde 2022. Para revisar un libro antes de enviarlo a ningún sitio, ábrelo en Calibre o pásalo por EPUBCheck, el validador que usan las propias tiendas.
Primero el índice: cada capítulo debe llevar el nombre de su encabezado. Luego cualquier página con una fórmula o un diagrama: viajan como MathML y SVG, que todos los lectores actuales muestran y algunos modelos de tinta electrónica antiguos no.