Le Markdown permet aux développeurs, aux rédacteurs et aux applications de prise de notes de garder un texte lisible en texte brut tout en marquant titres, listes et mises en valeur. La plupart des lecteurs ne savent pourtant pas l’ouvrir mis en forme. Markdown en PDF convertit le fichier avec Pandoc et le présente comme un document stylé : un README, un compte rendu de réunion ou une documentation devient un PDF lisible par tous.
Comment utiliser Markdown en PDF
- Ajoutez le fichier .md ou .markdown.
- Cliquez sur Convertir en PDF.
- Téléchargez le PDF.
- Vérifiez les tableaux, les blocs de code et les liens dans le résultat.
Ce qui est mis en forme
Pandoc comprend la syntaxe Markdown courante : titres, paragraphes, gras et italique, listes numérotées ou à puces, citations, liens, filets horizontaux, blocs de code délimités et tableaux à barres verticales. Il les convertit en HTML, ensuite mis en page sur des pages PDF, et les liens restent cliquables dans le PDF. La notation mathématique écrite en TeX n’est pas composée sous forme d’équations : les documents très mathématiques ont besoin d’un outil de composition dédié.
Images et serveurs sans Pandoc
L’outil convertit un seul fichier Markdown : les images référencées par des chemins relatifs ne sont donc pas disponibles, et les images provenant d’adresses web sont bloquées par sécurité. Convertissez les schémas séparément avec Images en PDF si vous en avez besoin. La mise en forme dépend de la présence de Pandoc sur le serveur ; sans lui, VelloDoc produit tout de même un PDF, mais affiche le Markdown en texte brut avec ses symboles visibles.
Circuits de documentation
Markdown en PDF convient au partage de documentation avec des personnes extérieures à un dépôt de code, comme des clients, des auditeurs ou des responsables. Regroupez plusieurs fichiers convertis en un manuel avec Fusionner PDF et numérotez les pages avec Numéroter les pages. Pour de simples notes sans structure, TXT en PDF suffit, et PDF en Markdown récupère le texte. Le guide des formats explique les compromis.
Quand utiliser Markdown en PDF
README pour les non-développeurs
Donnez à des clients ou à des responsables un PDF lisible du README d’un projet, sans leur demander de parcourir un dépôt.
Comptes rendus et journaux
Transformez des notes tenues dans des applications Markdown en documents à classer, imprimer ou envoyer comme procès-verbaux.
Documentation technique
Regroupez guides d’installation et procédures d’exploitation en PDF pour des audits, des passations ou une consultation hors ligne.
Limites à connaître
Markdown en PDF convertit un fichier à la fois : les images relatives ne sont pas incluses et les images distantes sont bloquées. Les formules TeX ne sont pas composées. La mise en forme complète nécessite Pandoc sur le serveur ; sans lui, le résultat est du texte brut. WeasyPrint est également requis.
Markdown en PDF : questions fréquentes
Quelle syntaxe Markdown est prise en charge ?
Titres, mises en valeur, listes, citations, liens, blocs de code délimités, filets horizontaux et tableaux à barres verticales sont tous pris en charge grâce à Pandoc.
Pourquoi mes images sont-elles absentes ?
Seul le fichier Markdown est envoyé : les images référencées par des chemins relatifs sont introuvables, et les images distantes sont bloquées. Convertissez les images séparément et assemblez les PDF si nécessaire.
Pourquoi mon PDF affiche-t-il les symboles Markdown bruts ?
Pandoc n’est pas installé sur le serveur : le fichier a donc été rendu en texte brut. Un serveur doté de Pandoc produit un résultat mis en forme.
Le code bénéficie-t-il de la coloration syntaxique ?
Les blocs de code conservent leur mise en page à chasse fixe et leurs retours à la ligne. La coloration dépend de la version de Pandoc du serveur : ne comptez pas sur elle pour comprendre le code.