Comment convertir Markdown en PDF sans perdre la mise en forme (2026)
Vous avez rédigé un document Markdown impeccable. Vous cliquez sur « exporter en PDF ». Soudain, les blocs de code se coupent mal, les tableaux débordent de la page et la moitié d'un paragraphe est tranchée en deux.
Ce guide explique comment convertir Markdown en PDF sans perdre la mise en forme — y compris le code, les tableaux, les images, les liens et les sauts de page — à l'aide d'un convertisseur en ligne gratuit, de VS Code et de Pandoc.
Pourquoi Markdown → PDF dérape
Markdown est du texte brut ; le PDF est une page fixe. La plupart des problèmes de mise en forme viennent de quatre lacunes :
| Problème | Ce que vous voyez dans le PDF | Cause |
|---|---|---|
| Blocs de code coupés | Lignes tronquées aux bords de la page | Pas de contrôle des sauts de page |
| Tableaux rognés | Colonnes manquantes à droite | Largeur de page insuffisante |
| Polices modifiées | Corps en serif, tailles de police à chasse fixe étranges | Correspondance de polices manquante |
| Dernière page vide | Page finale vierge | Sauts de ligne finaux / marges |
Corrigez ces points et votre PDF ressemblera à l'aperçu.
Méthode 1 : convertisseur en ligne gratuit (la plus rapide)
L'idéal quand vous voulez un PDF en un clic, sans installation.
- Ouvrez le convertisseur Markdown → PDF
- Collez votre Markdown (ou téléversez un fichier
.md) - Choisissez un modèle (Classique, Moderne, Académique…)
- Cliquez sur Télécharger le PDF
Ce qui reste intact :
- Titres et espacement
- Gras, italique,
code en ligne - Blocs de code entre délimiteurs avec coloration syntaxique
- Tableaux, listes, citations
- Images et liens
Astuce : choisissez le modèle avant d'exporter. Les modèles académiques ajoutent des marges plus resserrées et une meilleure hiérarchie de titres pour l'impression.
Méthode 2 : VS Code (le meilleur pour la documentation dans un dépôt)
Si le Markdown se trouve à côté de votre code :
- Installez Markdown PDF (ou Markdown All in One + impression)
- Ouvrez le fichier
.md Cmd/Ctrl+Shift+P→ Markdown PDF: Export (pdf)- Enregistrez à côté du fichier source
L'aperçu de VS Code se rapproche du Markdown façon GitHub, donc les captures de votre README correspondront à ce que vous avez déjà relu.
Méthode 3 : Pandoc (le meilleur pour le traitement par lots / CI)
Pour de nombreux fichiers ou des builds automatisés :
pandoc README.md -o README.pdf --pdf-engine=xelatex
Options utiles :
# Keep code line breaks
pandoc doc.md -o doc.pdf --wrap=pre --highlight-style=tango
# Custom page size + margins
pandoc doc.md -o doc.pdf -V geometry:margin=1in -V papersize:a4
Pandoc est puissant mais nécessite un moteur LaTeX installé. Pour des exports ponctuels, le convertisseur en ligne est plus simple.
Gardez ces 6 détails de mise en forme intacts
1. Blocs de code (surtout les lignes longues)
Préférez les blocs entre délimiteurs avec une étiquette de langue :
```python
def hello():
print("Hello, PDF!")
```
- Utilisez une étiquette de langue pour que la coloration fonctionne
- Évitez autant que possible les blocs d'une seule ligne de plus de ~80 caractères
- Si une ligne doit rester longue, assurez-vous que l'exporteur fait la cote ou défile — elle ne doit pas être tronquée
2. Tableaux
Gardez les en-têtes courts. Les tableaux larges sont la cause n°1 de colonnes qui disparaissent dans le PDF :
| Format | Best for | Editable? |
|--------|-----------------|-----------|
| Markdown | Writing | Yes |
| PDF | Sharing/print | No |
| DOCX | Review cycles | Yes |
Si un tableau a de nombreuses colonnes, divisez-le ou supprimez les colonnes optionnelles avant l'export.
3. Sauts de page (lorsque c'est important)
La plupart des exporteurs respectent le HTML simple inséré dans Markdown :
<div style="page-break-after: always;"></div>
Utilisez-le avant les chapitres importants pour qu'un titre ne se retrouve jamais seul en bas de page.
4. Images
- Utilisez des chemins relatifs (
./images/chart.png) ou des URL HTTPS complètes - Préférez le PNG/JPEG en dessous de ~1–2 Mo
- Ajoutez un texte alternatif — il devient aussi l'étiquette d'accessibilité du PDF
5. Liens
À l'impression, les URL longues font désordre. Préférez un texte de lien descriptif :
[Guide de syntaxe Markdown](/blog/markdown-syntax-guide)
6. Hiérarchie des titres
Restez sur un seul # pour le titre, puis ## / ###. Sauter des niveaux casse les signets PDF et les outils de table des matières.
Liste de vérification avant l'export
- Un seul titre
# - Blocs de code entre délimiteurs + langue
- Tableaux qui tiennent en page portrait (~6–8 colonnes max)
- Images qui s'affichent dans l'aperçu
- Pas de HTML accidentel dans le corps du texte
- L'aperçu correspond à ce que vous voulez imprimer
FAQ
Comment convertir Markdown en PDF gratuitement ?
Collez votre .md dans un outil en ligne Markdown → PDF et téléchargez le résultat. Sans inscription, sans filigrane — tout s'exécute dans votre navigateur.
Pourquoi mes blocs de code sont-ils coupés dans le PDF ?
Des lignes longues et aucune gestion des sauts de page. Utilisez des blocs entre délimiteurs, faites la cote des lignes longues et exportez avec un outil qui divise les blocs trop volumineux au lieu de tronquer au milieu d'une ligne.
Puis-je conserver la coloration syntaxique dans le PDF ?
Oui. Utilisez un convertisseur qui génère le HTML coloré avant la sortie PDF (la plupart des outils en ligne et l'extension Markdown PDF de VS Code le font).
Markdown vers PDF ou Markdown vers Word — que choisir ?
Choisissez PDF pour le partage/l'impression final (mise en page figée). Choisissez Word quand quelqu'un doit encore éditer. Voir Markdown vs HTML vs LaTeX si vous hésitez encore sur le format source.
Comment convertir Markdown en PDF sur Mac / Windows / Linux ?
Les mêmes étapes sur chaque OS : utilisez un convertisseur en ligne dans le navigateur, ou VS Code / Pandoc si vous préférez une chaîne locale.
Étapes suivantes
- Exportez un exemple : Markdown → PDF
- Besoin d'éditer ensuite ? Markdown → Word
- Approfondissez la syntaxe : Guide de syntaxe Markdown
- Consultation rapide : Aide-mémoire Markdown