Un EPUB est un zip de pages web avec une table des matières, et un fichier Markdown en a déjà fait l’essentiel du chemin.
Une liseuse construit sa table des matières et son bouton « chapitre suivant » à partir de fichiers séparés, pas de titres : une seule longue page est un livre sans chapitres, aussi bien titrée soit-elle. Un livre veut aussi ses images à l’intérieur — la plupart des liseuses n’en chargent pas depuis le web —, un manifeste qui nomme chaque fichier, ainsi qu’un titre et une langue, qui servent à la césure et à la lecture à voix haute.
Des titres qui se répètent. Deux titres `#` de premier niveau ou plus donnent chacun un chapitre ; un titre `#` au-dessus de plusieurs sections `##` donne un chapitre par section, le titre ouvrant le premier. Un document sans l’un ni l’autre est un seul chapitre — ce qu’il était déjà.
Apple Books, Google Play Books, Kobo, Calibre et Thorium ouvrent un EPUB directement, et Send to Kindle l’accepte depuis 2022. Pour vérifier un livre avant de l’envoyer où que ce soit, ouvrez-le dans Calibre ou passez-le dans EPUBCheck, le validateur qu’utilisent les librairies elles-mêmes.
La table des matières d’abord : chaque chapitre doit porter le nom de son titre. Puis toute page contenant une formule ou un diagramme — ils voyagent en MathML et en SVG, que toutes les liseuses actuelles affichent et certains anciens modèles à encre électronique non.