Md en PDF : Markdown vers PDF

Fonctionnement

1. 1Collez votre Markdown dans la zone, ou ouvrez un fichier .md, .markdown ou .txt depuis votre appareil.
2. 2Vérifiez l'aperçu. Il montre le document avant la conversion.
3. 3Choisissez le format de page, la marge, la taille du texte et l'orientation.
4. 4Cliquez sur « Convertir ». L'utilisation anonyme demande d'abord une vérification de sécurité. Les utilisateurs connectés passent cette étape.
5. 5Téléchargez le PDF. Les résultats sont supprimés après 10 minutes, enregistrez donc le fichier peu après la conversion.

Exemple de résultat

Comment convertir du Markdown en PDF

Ce convertisseur markdown en pdf fonctionne en trois étapes. D'abord, votre Markdown est transformé en HTML dans l'onglet de votre navigateur. Ensuite, le HTML nettoyé est envoyé à notre moteur de rendu, qui l'imprime en PDF avec Chromium sans interface (headless). Enfin, vous téléchargez le fichier.

Vous n'avez pas besoin d'installer de logiciel ni de créer de compte. L'utilisation anonyme demande une vérification de sécurité. Les utilisateurs connectés passent cette vérification et utilisent des crédits. Nous n'ajoutons aucun filigrane.

Le PDF utilise une police sans empattement, des titres avec un filet sous les deux premiers niveaux, des blocs de code gris, des tableaux bordés et des citations mises en forme. Vous n'avez rien à ajouter à votre Markdown pour la mise en forme.

Ce que prend en charge le Markdown

Le convertisseur utilise GitHub Flavored Markdown, les fonctions suivantes sont donc activées :

• Tableaux, imprimés avec des bordures
• Listes de tâches, écrites - [ ] pour un élément non coché et - [x] pour un élément terminé
• Texte barré
• Liens automatiques, comme une adresse web écrite telle quelle
• Le HTML saisi dans le Markdown est nettoyé avant l'impression. Les scripts et les attributs d'événements sont supprimés, ils ne s'exécutent donc pas dans le PDF.

Fichiers README et images

Vous pouvez convertir directement un fichier README.md. Ouvrez le fichier ou collez son texte, et les titres, listes, tableaux et blocs de code gardent leur structure.

Les images fonctionnent lorsque l'adresse est un lien public en https:// ou http://, ou une URL data:. Les chemins relatifs, comme ./img/a.png, ne se chargent pas, car le convertisseur ne voit pas le dossier dans lequel se trouve votre fichier.

Si une image manque dans le PDF, ouvrez d'abord son adresse dans un nouvel onglet du navigateur. Un lien qui ne s'ouvre pas pour vous ne se chargera pas non plus dans le PDF.

Blocs de code et tableaux

Un bloc de code délimité reçoit des couleurs de syntaxe lorsque vous indiquez le langage après la première clôture, par exemple python. Les couleurs fonctionnent pour JavaScript, TypeScript, Python, JSON, Shell, CSS, HTML et XML, SQL, Go, Rust, Java, C, C++, C#, PHP, Ruby, YAML, Markdown, Diff, Kotlin et Swift.

Un bloc de code sans langage, ou avec un langage absent de cette liste, s'imprime en texte brut sur un fond gris.

Les tableaux larges ont besoin de place. Pour un tableau à nombreuses colonnes, choisissez le paysage, qui donne plus de largeur à chaque ligne.

Format de page, marge et taille du texte

Choisissez A4, Letter, Legal, A3 ou A5 comme format de page. Réglez la marge en millimètres.

Réglez la taille du texte entre 9 et 14 pt. Une taille plus petite fait tenir plus de texte sur une page, et une taille plus grande se lit plus facilement sur papier.

Vous pouvez aussi activer le paysage et choisir si les arrière-plans sont imprimés. Les arrière-plans comprennent les blocs de code gris.

Ce que l'outil ne fait pas

Cet outil est destiné aux documents Markdown. Les fonctions suivantes ne sont pas prises en charge :

• Les formules mathématiques LaTeX ne sont pas rendues.
• Les diagrammes Mermaid ne sont pas dessinés.
• Les notes de bas de page ne sont pas prises en charge.
• Le bloc de métadonnées en tête de fichier n'est pas traité.
• L'outil en ligne n'ajoute ni table des matières, ni numéros de page, ni en-têtes ni pieds de page.
• L'API peut ajouter des en-têtes et des pieds de page. Ses modèles d'en-tête et de pied de page peuvent afficher les numéros de page, comme décrit dans la section API ci-dessous.

Où a lieu la conversion

Votre Markdown est lu et transformé en HTML dans votre navigateur. Le HTML y est nettoyé, puis envoyé au moteur de rendu. Le fichier .md lui-même n'est pas ce que reçoit le moteur de rendu.

Le moteur charge le HTML dans Chromium sans interface (headless), à l'intérieur d'un conteneur de travail aux ressources limitées, avec une limite de temps stricte pour chaque tâche. Il imprime la page en PDF et conserve le résultat pour le téléchargement. Chaque conversion reçoit un contexte de navigateur neuf, les cookies et le cache ne sont donc pas partagés entre les tâches.

Le résultat est supprimé après 10 minutes. Un enregistrement de chaque tâche est conservé, et les utilisateurs connectés peuvent voir leurs tâches dans le tableau de bord.

API Markdown vers PDF

Pour convertir du Markdown dans votre propre code, transformez le Markdown en HTML avec une bibliothèque Markdown de votre langage, puis envoyez le HTML à l'API sous forme de requête html_to_pdf. C'est en résumé l'API Markdown vers PDF : l'API prend du HTML, pas du Markdown, donc la première étape reste dans votre code. Envoyez votre clé API comme jeton Bearer dans l'en-tête Authorization. La requête ressemble à ceci :

curl -X POST https://api.aiipworld.com/v1/render \
  -H "Authorization: Bearer $AIIPWORLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"html":"<h1>Release notes</h1><p>This HTML came from a Markdown file.</p>","output":"pdf","options":{"format":"A4"}}'

# returns {"job_id": "...", "status": "queued"}; then poll:
curl https://api.aiipworld.com/v1/jobs/JOB_ID -H "Authorization: Bearer $AIIPWORLD_API_KEY"

L'appel de rendu renvoie 202 avec un job_id. Interrogez GET /v1/jobs/:id jusqu'à ce que le statut soit succeeded, failed ou timeout. Téléchargez ensuite le fichier depuis download_url, qui est un lien signé de courte durée.

Cette version Node.js utilise marked, la bibliothèque qu'utilise aussi l'outil web, pour transformer un README.md en HTML. Elle ajoute un petit élément style, qui permet d'appliquer votre propre CSS au PDF, puis envoie la page à l'API. Le Markdown peut contenir du HTML brut, donc nettoyez-le d'abord si le texte ne vient pas de vous. L'outil web le fait dans votre navigateur avec DOMPurify.

// npm install marked
import { readFile } from "node:fs/promises";
import { marked } from "marked";
import { render } from "./aiipworld-pdf.mjs";

const markdown = await readFile("README.md", "utf8");
const css = `body { font-family: "Liberation Sans", Arial, sans-serif; line-height: 1.5; }
pre { background: #f3f4f6; padding: 8px; white-space: pre-wrap; }
table { border-collapse: collapse; } th, td { border: 1px solid #d9dbe8; padding: 4px 8px; }`;
const html = `<!doctype html><html><head><meta charset="utf-8"><style>${css}</style></head><body>${marked.parse(markdown)}</body></html>`;

const job = await render({ html, output: "pdf", options: { format: "A4" } }, "readme.pdf");
console.log(job.status, job.result.pages, "pages");

Les crédits des tâches échouées ou dont le délai est dépassé sont restitués. Il n'existe pas d'endpoint par lots, donc envoyez une requête par document. Les webhooks et les modèles avec données JSON ne sont pas encore disponibles. L'API peut aussi ajouter des en-têtes, des pieds de page et des numéros de page, ce que l'outil web ne fait pas.

Utiliser un fichier README ou Markdown de GitHub

Si vous avez besoin d'un PDF de votre README à partager, ouvrez le fichier README.md ou collez son texte ici. Les titres, listes et blocs de code gardent leur structure, le document reste donc lisible sur papier.

Pour convertir du Markdown GitHub en PDF, le convertisseur fonctionne avec les fonctions GitHub Flavored Markdown qu'il prend en charge : tableaux, listes de tâches, texte barré et liens automatiques. Le PDF utilise son propre style de document, il ne reproduira donc pas exactement la mise en page de GitHub.

Polices et textes non anglais

Le PDF utilise les polices installées sur le serveur de rendu. Les polices installées sur votre appareil ne sont pas disponibles, le résultat peut donc différer de votre éditeur.

Les caractères couverts par une police du serveur s'impriment dans le PDF, y compris le chinois, le japonais et le coréen. Les emojis sont dessinés avec Noto Color Emoji.

Fichiers MD : convertir un .md en PDF en ligne

Un fichier .md est un fichier texte brut écrit en Markdown. Ce convertisseur md en pdf le lit comme du texte : ouvrez le fichier ou collez son contenu, vérifiez l'aperçu et convertissez. Pour convertir un md en pdf, vous n'avez besoin ni d'éditeur ni de compte.

La conversion du fichier md en pdf transforme votre Markdown en HTML dans l'onglet de votre navigateur, puis notre serveur de rendu imprime ce HTML en PDF. Elle fonctionne donc comme un outil de Markdown en PDF en ligne, depuis tout appareil disposant d'un navigateur. Si vous voulez obtenir un fichier md en pdf avec un autre format de page ou une autre marge, modifiez ces réglages et convertissez de nouveau.

Questions