Convert2EPUB
Menu
← Blog

Comment convertir du Markdown en EPUB : Pandoc, ou un convertisseur sans installation

Dernière mise à jour : 11 novembre 2026

Le moyen le plus rapide de convertir du Markdown en EPUB, c'est Pandoc : lancez pandoc book.md -o book.epub et vous obtenez un EPUB valide. Si vous ne voulez rien installer, téléversez le fichier .md dans un convertisseur en ligne comme Convert2EPUB. Dans les deux cas, la qualité de l'ebook dépend surtout de la façon dont vous structurez vos titres et vos métadonnées avant la conversion.

De quoi avez-vous besoin pour convertir un fichier Markdown en EPUB ?

Il vous faut un fichier Markdown avec une structure de titres claire, un titre et un auteur, et un outil capable de produire de l'EPUB. Pandoc est l'outil de référence en ligne de commande. Un convertisseur dans le navigateur fait le même travail sans installation.

Avant la conversion, assurez-vous que la source est prête :

  • Un titre # par chapitre. Par défaut, Pandoc découpe un EPUB en chapitres au niveau des titres de niveau 1, d'après le guide de l'utilisateur de Pandoc. Si vous écrivez vos chapitres en ##, modifiez-les ou définissez le niveau de découpage (voir plus bas).
  • Le titre et l'auteur dans un bloc de métadonnées en haut du fichier, et pas seulement dans un titre.
  • Des images avec des chemins relatifs valables depuis le dossier où vous lancez la commande, avec un texte de remplacement.
  • Pas de HTML brut dont vous ne pouvez pas vous passer. Les balises simples passent généralement, mais les scripts, les iframes et les astuces CSS n'ont pas leur place dans un fichier destiné à une liseuse.

Comment convertir du Markdown en EPUB avec Pandoc ?

Installez Pandoc, placez un bloc de métadonnées YAML en haut de votre fichier et lancez une seule commande. Pandoc construit la table des matières à partir de vos titres.

1. Ajoutez les métadonnées

Pandoc lit les métadonnées EPUB dans un bloc YAML du fichier Markdown, ou dans un fichier YAML séparé, comme le décrit le manuel de Pandoc. Un bloc minimal :

---
          title: The Lighthouse Letters
          author: Dana Whitfield
          lang: en-GB
          date: 2026-11-11
          cover-image: cover.jpg
          ---

lang compte plus qu'on ne le croit. Ce champ commande la césure et la synthèse vocale sur certaines liseuses. La date est à votre choix : indiquez la date de publication que vous voulez voir affichée.

2. Lancez la commande

pandoc book.md -o book.epub --toc --toc-depth=2
  • --toc-depth définit le nombre de niveaux de titre qui apparaissent dans la table des matières. D'après le manuel de Pandoc, la valeur par défaut est 3 : les niveaux 1, 2 et 3 sont donc listés. Pour un roman, 1 ou 2 donne généralement un résultat plus net.
  • --epub-cover-image=cover.jpg fait la même chose que le champ cover-image. Pandoc recommande une couverture de moins de 1 000 pixels de large et de haut.
  • --epub-title-page=false supprime la page de titre générée si vous avez écrit la vôtre.

3. Combinez plusieurs fichiers

Beaucoup d'auteurs gardent un fichier par chapitre. Passez-les dans l'ordre et Pandoc les assemble :

pandoc 01-intro.md 02-first-night.md 03-storm.md -o book.epub

Faites commencer les noms de fichiers par des numéros pour que l'ordre du shell corresponde à l'ordre de lecture. Placez le bloc de métadonnées dans le premier fichier uniquement.

4. Mettez-le en forme, avec légèreté

Pandoc applique une feuille de style par défaut. Pour la changer, passez --css=epub.css. Gardez un CSS minimal : réglez le retrait des paragraphes et les marges des titres, et ne touchez ni à la police ni à la taille. Les liseuses laissent le lecteur choisir l'une et l'autre, et les imposer lui retire ce contrôle.

Comment structurer les titres pour obtenir les bons chapitres et une bonne table des matières ?

Utilisez # pour les chapitres et ## pour les sections qu'ils contiennent, et ne sautez pas de niveau. Le menu de navigation de l'EPUB est généré à partir de ces titres : la structure que vous écrivez est celle que le lecteur obtient.

Votre MarkdownCe qui se passe dans l'EPUB (réglages par défaut de Pandoc)
# ChapterCommence un nouveau fichier de chapitre et apparaît dans la table des matières
## SectionApparaît dans la table des matières (profondeur 3 par défaut) mais reste dans le fichier du chapitre
### SubsectionN'apparaît dans la table des matières que si la profondeur le permet
Texte en gras mis en forme comme un titrePas un titre ; n'apparaîtra pas dans la table des matières

Deux problèmes courants :

  • Un livre avec un seul titre #. Tout le livre devient un seul gros fichier. Le manuel de Pandoc précise que cette option ne touche que la composition interne de l'EPUB, et non la façon dont les chapitres apparaissent au lecteur, et que certaines liseuses peuvent être lentes avec de très gros fichiers de chapitre. Pour un long document avec peu de titres de premier niveau, utilisez --split-level=2 ou 3.
  • Un titre écrit en # et des chapitres aussi en #. Le titre apparaît alors comme un chapitre. Placez le titre dans le bloc YAML et réservez # aux vrais chapitres.

Si votre table des matières paraît toujours fausse ensuite, notre guide pour réparer une table des matières EPUB manquante ou défectueuse passe en revue les vérifications à faire.

Peut-on convertir du Markdown en EPUB sans installer Pandoc ?

Oui. Un convertisseur en ligne qui accepte les fichiers .md vous permet de téléverser le fichier, de définir le titre et l'auteur, puis de télécharger l'EPUB. C'est adapté aux conversions ponctuelles et à tous ceux qui ne veulent pas de ligne de commande.

Voici comment les deux approches se comparent :

PandocConvertisseur dans le navigateur
Installation nécessaireOuiNon
Reproductible dans un script de build ou en CIOuiNon
CSS, polices et filtres personnalisésContrôle totalLimité aux réglages de l'outil
Fusion de plusieurs fichiersOui, en les listantLes réunir d'abord en un seul fichier
Idéal pourLes livres que vous régénérez souventLes conversions rapides et occasionnelles

La zone de téléversement de Convert2EPUB cite le Markdown parmi les formats acceptés, avec une limite de 100 Mo. Le convertisseur propose des réglages pour le titre, l'auteur, le mode redimensionnable ou à mise en page fixe, et l'appareil cible. Son modèle Standard gratuit est présenté sur le site comme adapté aux mises en page simples, comme celles des romans, ce que sont aussi la plupart des manuscrits Markdown. Si vous ne savez pas si le redimensionnable est le bon choix, consultez notre comparatif EPUB redimensionnable ou mise en page fixe. Pour de la prose, c'est le cas.

Que vérifier avant d'envoyer l'EPUB sur une liseuse ?

Ouvrez le fichier dans au moins une vraie application de lecture et parcourez une courte liste de vérification. La plupart des problèmes de conversion de Markdown en EPUB se voient dans les cinq premières minutes.

  • Table des matières : ouvrez le menu de navigation. Chaque chapitre doit y figurer, dans l'ordre, avec un nom logique.
  • Couverture et titre : la couverture doit s'afficher dans la vue de votre bibliothèque, et le titre comme l'auteur doivent être corrects.
  • Images : vérifiez que chaque image apparaît, s'adapte à l'écran et n'a pas de bordure parasite.
  • Blocs de code et tableaux : sur les petites liseuses, les longues lignes des blocs de code peuvent déborder de l'écran. Coupez-les ou raccourcissez-les. Pour un écran de 6 pouces, mieux vaut réécrire les tableaux larges sous forme de listes.
  • Notes de bas de page : Pandoc transforme les notes de bas de page Markdown en notes liées. Touchez-en une et vérifiez que le lien vous ramène bien au texte.
  • Validation : si vous comptez publier sur une boutique, passez le fichier dans EPUBCheck, le validateur soutenu par le W3C que les boutiques utilisent couramment. Il repère des problèmes que les liseuses pardonnent sans rien dire.

Pour les petits écrans e-ink, notre article sur les réglages EPUB pour une liseuse e-ink de 6 pouces explique ce qu'il faut régler dans le fichier et ce qu'il faut régler sur l'appareil.

Si vous préférez vous passer de toute cette mise en place, vous pouvez téléverser votre fichier .md sur Convert2EPUB et télécharger un EPUB redimensionnable.

Peut-on lire sur Kindle un EPUB créé à partir de Markdown ?

Oui. Envoyez l'EPUB sur votre Kindle par e-mail ou via l'application Send to Kindle : inutile de le convertir en MOBI ou en AZW3. La page de Convert2EPUB elle-même indique que Send to Kindle accepte un EPUB tel quel. Notre guide pour envoyer un EPUB sur votre Kindle détaille les étapes.

Questions fréquentes

Pandoc peut-il convertir directement du Markdown en MOBI ou en AZW3 ?

Non. Pandoc produit de l'EPUB, pas du MOBI ni de l'AZW3. Les méthodes actuelles d'envoi sur Kindle acceptent directement l'EPUB : une conversion supplémentaire est donc généralement inutile. Seules les très anciennes Kindle ont besoin du MOBI.

Pourquoi mon EPUB ne forme-t-il qu'un seul chapitre géant ?

Par défaut, Pandoc découpe les chapitres au niveau des titres de niveau 1. Si votre Markdown ne contient qu'un seul # ou aucun, tout se retrouve dans un seul fichier. Passez vos titres de chapitre en #, ou définissez --split-level=2.

Comment ajouter une image de couverture ?

Ajoutez cover-image: cover.jpg au bloc YAML, ou passez --epub-cover-image=cover.jpg. Le manuel de Pandoc recommande une image de moins de 1 000 pixels de large et de haut. Indiquez un chemin relatif au dossier depuis lequel vous lancez la commande.

La mise en forme Markdown, comme le gras, les listes et les citations, est-elle conservée ?

Oui. Les éléments Markdown standard deviennent leurs équivalents HTML dans l'EPUB, et c'est le style propre à la liseuse qui les affiche. Les extensions varient selon l'outil : vérifiez donc dans le résultat les syntaxes inhabituelles, comme les listes de définitions ou les listes de tâches.

Puis-je convertir tout un dossier de fichiers Markdown ?

Avec Pandoc, oui. Listez les fichiers dans l'ordre ou utilisez un motif générique comme *.md, comme le fait un tutoriel de la DEV Community avec un dépôt de documentation. Numérotez vos noms de fichiers pour que l'ordre soit prévisible.

Prêt à convertir votre propre PDF ? C'est gratuit pour les documents texte ordinaires, sans compte.

Convertir un PDF en EPUB →