FileReshape
FR

Convertir Markdown en PDF

Le convertisseur Markdown en PDF de FileReshape met en forme un fichier .md dans votre navigateur, avec les titres, listes, tableaux, blocs de code et listes de tâches à la manière de GitHub, et vous enregistrez le résultat en PDF avec du texte sélectionnable via la fenêtre d'impression du navigateur. Le fichier n'est pas envoyé. Les images seulement liées, et non intégrées, apparaissent sous forme de leur description, et il n'y a ni coloration syntaxique ni bouton de téléchargement direct.

Un fichier ne s'est pas converti correctement ? Écrivez à [email protected], idéalement avec un petit fichier d'exemple, et ce sera corrigé.

L'essentiel

Pourquoi transformer du Markdown en PDF

Le Markdown est la façon dont les développeurs, les rédacteurs et les applications de notes comme Obsidian, Joplin et Typora conservent le texte : lisible en texte brut, et mis en forme quand une application l'affiche. En dehors de ces applications, un fichier .md n'est qu'un mur de dièses et d'astérisques, ce qui n'est pas ce que vous voulez envoyer à un client, rendre ou imprimer. Cet outil lit le Markdown dans votre navigateur avec marked, un analyseur open source qui suit les règles du GitHub Flavored Markdown, et le met en page comme un document propre : titres, texte en gras et en italique, listes numérotées et à puces, listes de tâches avec cases à cocher, tableaux avec bordures, citations, et blocs de code dans une police à chasse fixe qui passent à la ligne au lieu de dépasser de la page. Le moteur d'impression du navigateur écrit ensuite le PDF, si bien que le texte reste net et consultable. L'en-tête YAML (front matter) en haut du fichier, utilisé par les blogs et les générateurs de sites statiques, n'est pas repris dans le PDF.

Comment convertir du Markdown en PDF

  1. Déposez votre fichier .md dans le cadre, ou cliquez pour le choisir. Un aperçu du document mis en forme s'affiche.
  2. Choisissez le format de page, les marges et la taille du texte.
  3. Cliquez sur « Créer le PDF ». Dans la fenêtre d'impression de votre navigateur, choisissez « Enregistrer au format PDF » comme imprimante ou destination, puis enregistrez le fichier.

Ce qu'il faut savoir sur le Markdown et le PDF

Les images seulement liées

En Markdown, les images sont généralement désignées par leur adresse, comme ![Logo](images/logo.png) ou un lien web. L'outil ne dispose que du fichier .md, pas du dossier qui l'entoure, et il ne récupère rien sur le web : ces images apparaissent donc sous forme d'un petit cadre avec leur description. Les images intégrées au fichier sous forme d'URL data sont imprimées. Pour obtenir les images dans le PDF autrement, ouvrez le Markdown dans un éditeur qui les affiche et imprimez depuis celui-ci.

Le HTML dans le Markdown

Le HTML simple, comme <br>, <sup>, <details> ou un tableau écrit en HTML, est conservé. Les scripts, cadres, formulaires, styles et vidéos intégrées sont supprimés, car ils n'ont pas leur place dans un document imprimé et pourraient être dangereux.

Pas de coloration syntaxique

Les blocs de code sont imprimés dans une police à chasse fixe avec un léger cadre, mais sans les couleurs qu'un éditeur utilise pour les mots-clés et les chaînes. Les longues lignes de code passent à la ligne pour que rien ne soit coupé au bord de la page.

Les variantes de Markdown

Les tableaux, les listes de tâches, le texte barré et les liens automatiques suivent les règles de GitHub, que la plupart des applications partagent. Les extensions propres à certaines applications, comme les notes de bas de page, les formules mathématiques, les diagrammes Mermaid, les liens wiki entre notes ou les callouts d'Obsidian, apparaissent sous forme de texte brut.

À propos des formats

Markdown

Le Markdown est un format en texte brut pour rédiger des documents mis en forme, créé par John Gruber en 2004. Les dièses font les titres, les astérisques le gras et l'italique, et les tirets les listes. GitHub, GitLab, Reddit, Obsidian, les exports de Notion et de nombreux outils de documentation l'utilisent.

  • Un fichier .md est du texte brut : il s'ouvre dans n'importe quel éditeur de texte et fonctionne bien avec un gestionnaire de versions comme Git.
  • Le GitHub Flavored Markdown (GFM) ajoute aux règles d'origine les tableaux, les listes de tâches, le texte barré et les liens automatiques.
  • Les images sont généralement liées par leur adresse : elles se trouvent dans des fichiers séparés à côté du fichier .md ou sur le web.

PDF

Le PDF (Portable Document Format) a été créé par Adobe en 1993 et est une norme ISO depuis 2008. Un fichier PDF s'affiche de la même façon sur tous les appareils : c'est pourquoi on l'utilise pour les contrats, les factures, les formulaires, les manuels et les documents numérisés.

  • Une page peut contenir du texte, des graphiques vectoriels et des images, chacun placé avec précision.
  • Un document numérisé se compose généralement d'une image par page.
  • Un PDF peut être protégé par un mot de passe, exigé pour l'ouvrir ou le modifier.

Questions fréquentes

Mon fichier Markdown est-il envoyé sur un serveur ?

Non. Le Markdown est lu et mis en forme par votre navigateur sur votre appareil, et le PDF est écrit par la fonction d'impression du navigateur. Rien n'est envoyé à un serveur.

Comment supprimer la date et l'adresse web sur chaque page ?

Désactivez « En-têtes et pieds de page » dans la fenêtre d'impression du navigateur, généralement sous Plus de paramètres. Cela supprime aussi le titre de la page en haut.

Pourquoi mes blocs de code n'ont-ils pas de fond gris dans le PDF ?

Les navigateurs n'impriment pas les couleurs d'arrière-plan, sauf si « Graphiques d'arrière-plan » est activé dans la fenêtre d'impression. Le cadre autour des blocs de code s'imprime dans tous les cas.

Puis-je convertir un README de GitHub ?

Oui. Téléchargez le fichier README.md et déposez-le ici. Les badges et les captures d'écran liés depuis le web apparaissent sous forme de leur description.

Autres outils