Le Markdown est idéal pour écrire, mais les destinataires de vos documents attendent souvent une page web ou un PDF. Bonne nouvelle : convertir du Markdown est facile, et dans la plupart des cas, nul besoin d’une chaîne d’outils compliquée.
Voici quatre méthodes, de la plus rapide à la plus configurable, ainsi qu’une série d’astuces pour obtenir un résultat professionnel.
Comparatif rapide
| Méthode | HTML | Installation | Idéal pour | |
|---|---|---|---|---|
| Export depuis un éditeur dans le navigateur | ✅ | ✅ (impression) | Rien | Documents du quotidien, partage rapide |
| VS Code + extension | ✅ | ✅ | Éditeur + extension | Ceux qui écrivent déjà dans VS Code |
| Pandoc | ✅ | ✅ | Pandoc (+ un moteur PDF) | Livres, articles scientifiques, chaînes automatisées |
| Un script (markdown-it, marked) | ✅ | — | Node.js | Sites sur mesure et étapes de build |
1. Exporter depuis un éditeur dans le navigateur
Le plus rapide est un éditeur qui exporte directement. Dans Markdown Preview Editor, ouvrez ou collez votre document — dans la version en ligne ou votre propre copie — puis utilisez les boutons de l’en-tête :
- HTML crée un unique fichier
.htmlautonome. Les styles, la coloration du code, les formules, les diagrammes et les images ouvertes avec le document y sont intégrés : le fichier s’affiche correctement sur n’importe quel ordinateur et peut être joint à un e-mail ou mis en ligne tel quel. - Imprimer ouvre la boîte de dialogue d’impression du navigateur. Choisissez Enregistrer au format PDF comme destination pour obtenir un PDF. Seul le document rendu est imprimé — ni barre d’outils, ni éditeur.
- Enregistrer télécharge la source Markdown dans un fichier
.md.
Comme tout se passe dans le navigateur, cette méthode convient aussi aux documents que vous préférez ne pas envoyer à un convertisseur en ligne.
Obtenir un PDF propre depuis la boîte de dialogue d’impression
- Réglez les Marges sur Par défaut ou Minimum, selon la quantité de texte souhaitée par page.
- Désactivez En-têtes et pieds de page pour supprimer la date et l’URL des bords de la page.
- Activez Graphiques d’arrière-plan si vous voulez conserver le fond des blocs de code et les lignes alternées des tableaux.
- Utilisez un thème clair pour l’impression : il économise l’encre et se lit mieux sur papier.
2. VS Code avec une extension
VS Code intègre un aperçu Markdown, mais pas de bouton d’export. Des extensions comme Markdown PDF ou Markdown Preview Enhanced ajoutent des commandes pour exporter en HTML et en PDF. C’est pratique si VS Code est déjà votre éditeur ; le style du résultat dépend de l’extension, et certaines téléchargent un navigateur headless lors de la première utilisation.
3. Pandoc, le convertisseur universel
Pandoc convertit entre des dizaines de formats et c’est l’outil de référence pour les livres, les articles universitaires et la documentation automatisée. Une fois installé, la conversion tient en une commande :
bash# Markdown vers une page HTML complète
pandoc report.md -o report.html --standalone --metadata title="Report"
# Markdown vers PDF (nécessite un moteur PDF, par ex. une distribution LaTeX)
pandoc report.md -o report.pdf --pdf-engine=xelatex
# Markdown vers Word, si quelqu’un insiste
pandoc report.md -o report.docx
Sans --standalone, Pandoc ne produit qu’un fragment HTML — pratique pour l’insérer dans une page existante. La sortie PDF nécessite un moteur séparé : une distribution LaTeX, ou un moteur basé sur HTML comme WeasyPrint. La force de Pandoc, c’est le contrôle : modèles, citations, sections numérotées et renvois.
4. Quelques lignes de JavaScript
Si le Markdown fait partie de votre propre site ou de votre processus de build, une bibliothèque est l’option la plus souple. Avec markdown-it :
jsimport MarkdownIt from 'markdown-it';
import { readFileSync, writeFileSync } from 'node:fs';
const md = new MarkdownIt({ linkify: true, typographer: true });
const body = md.render(readFileSync('README.md', 'utf8'));
writeFileSync('README.html', `<!doctype html><meta charset="utf-8"><title>README</title>${body}`);
Des plugins ajoutent notes de bas de page, listes de tâches, formules et plus encore. N’oubliez pas que le résultat n’est jamais plus sûr que ce qui entre : si le Markdown provient d’autres personnes, nettoyez le HTML (par exemple avec DOMPurify) avant de le publier.
Astuces pour un meilleur HTML et PDF
Commencez par un titre clair et unique
Les convertisseurs tirent le titre du document du nom de fichier, du premier titre ou de métadonnées explicites. Donnez à chaque document un nom de fichier descriptif et un seul titre # : le HTML et le PDF exportés seront faciles à reconnaître dans un dossier de téléchargements ou un onglet du navigateur.
Gardez les images à côté du document
Utilisez des chemins relatifs comme images/chart.png et gardez les fichiers dans le même dossier. Lorsque vous ouvrez le dossier entier dans Markdown Preview Editor, les images sont résolues et intégrées à l’export HTML. Les images distantes qui ne sont pas chargées dans l’aperçu ne sont pas intégrées non plus.
Maîtrisez les sauts de page
Le Markdown n’a pas de syntaxe de saut de page. Pour les documents imprimés, commencez les grandes sections par un titre ## et gardez des tableaux courts : les navigateurs évitent de couper les lignes d’un tableau, mais un très grand tableau continuera tout de même sur la page suivante. Dans les outils qui acceptent le HTML brut et les styles en ligne, comme Pandoc, vous pouvez insérer <div style="page-break-after: always"></div>.
Vérifiez formules et diagrammes avant d’exporter
Dans la plupart des outils, les formules et les diagrammes sont rendus par des bibliothèques JavaScript. Vérifiez-les d’abord dans l’aperçu — consultez nos guides sur les formules mathématiques en Markdown et les diagrammes Mermaid. Dans l’export HTML de Markdown Preview Editor, ils sont enregistrés sous forme de balisage et d’images déjà rendus : le fichier exporté n’a besoin d’aucun script.
Choisissez le thème en connaissance de cause
Un export HTML sombre est agréable à l’écran, mais mal adapté au papier. Exportez pour le support qu’utilisera votre lecteur.
Questions fréquentes
Comment convertir du Markdown en PDF gratuitement ?
Ouvrez le document dans un outil d’aperçu Markdown comme Markdown Preview Editor, cliquez sur Imprimer et choisissez Enregistrer au format PDF dans la boîte de dialogue d’impression. Pour un résultat automatisé ou de type livre, utilisez l’outil en ligne de commande gratuit Pandoc.
Comment convertir du Markdown en HTML sans rien installer ?
Utilisez un éditeur dans le navigateur doté d’un export HTML. Markdown Preview Editor crée un fichier HTML autonome, styles inclus, directement dans votre navigateur.
Les images sont-elles incluses dans le HTML exporté ?
Les images locales ouvertes avec le document sont intégrées au fichier HTML, qui fonctionne donc de manière autonome. Les images qui restent sur des serveurs distants ne sont pas intégrées.
Peut-on convertir du Markdown en Word (DOCX) ?
Oui, avec Pandoc : pandoc input.md -o output.docx. Vous pouvez aussi exporter en HTML et ouvrir le fichier dans Word, qui conserve l’essentiel de la mise en forme.