Voici markdowntopdf.dev: une API gratuite pour convertir le Markdown en PDF

Le Markdown est devenu la façon d'écrire par défaut. Les équipes techniques y rédigent leurs README et leurs procédures, et les modèles de langage y répondent. Quand un agent rédige un rapport, une soumission ou une lettre, le brouillon est presque toujours en Markdown.

Les gens qui lisent ces documents veulent pourtant un PDF. Passer de l'un à l'autre a toujours demandé plus d'efforts que nécessaire: installer Pandoc et un moteur LaTeX, faire tourner un navigateur sans interface, ou payer un service HTML vers PDF au document, après avoir écrit un gabarit HTML.

Aujourd'hui, nous lançons markdowntopdf.dev, une API gratuite qui le fait en un seul appel.

curl --data-binary @README.md https://markdowntopdf.dev/pdf -o README.pdf

C'est toute l'intégration. Pas de clé, pas d'inscription, et aucun filigrane sur le PDF.

Assez rapide pour un appel en direct

Un document d'une page se rend en aussi peu que 50 ms. Notre facture d'essai d'une page prend environ 55 ms aller-retour par Internet. C'est assez rapide pour produire le PDF pendant que l'utilisateur attend, plutôt que de mettre une tâche en file et d'envoyer un lien par courriel plus tard.

Rendre des documents rapidement, c'est ce que nous faisons toute la journée pour l'API CloudRaker. markdowntopdf.dev, c'est ce même travail, appliqué à l'entrée la plus simple qui soit.

À votre image

Par défaut, vous obtenez un document A4 sobre, en noir et blanc, composé en Inter. Toutes les options sont facultatives, et vous les envoyez en JSON avec le Markdown:

curl https://markdowntopdf.dev/pdf -H 'content-type: application/json' -o rapport.pdf \
  -d '{"markdown": "# Bonjour", "options": {"fonts": {"body": "Lora"}}}'

• Typographie. N'importe laquelle des quelque 1 800 familles de Google Fonts, choisie séparément pour le texte, chaque niveau de titre, les en-têtes de tableau et le code.
• Image de marque. Votre logo par URL ou en SVG intégré, sur la première page ou sur toutes. Des couleurs pour les liens, les en-têtes de tableau, les bordures et les rangées alternées.
• Mise en page. Format (A4, US Letter, A5, US Legal), marges, première page plus haute pour un papier à en-tête, texte d'en-tête et numéros de page dans le format de votre choix.
• Propriétés du PDF. Titre, auteur et sujet, pour que le fichier s'affiche correctement dans un système de gestion documentaire.

La mise en page par commentaires

Le Markdown ne permet pas de centrer un titre ni d'aligner à droite les totaux d'une facture. Des commentaires HTML, seuls sur leur ligne, comblent ce manque. Ils dirigent la mise en page et ne s'impriment jamais:

<!-- center -->
# Entente de services
Acme inc. et Northwind Traders
<!-- space: 2 -->

<!-- justify -->
La présente entente établit les conditions selon lesquelles Acme fournit ses services.

<!-- left -->, <!-- right -->, <!-- center --> et <!-- justify --> s'appliquent jusqu'au prochain commentaire d'alignement. <!-- fullwidth --> étire le tableau suivant sur toute la largeur de la page, et <!-- space: 3 --> ajoute trois lignes vides. Un commentaire d'alignement entre deux rangées d'un tableau réaligne toutes les rangées qui suivent: c'est ainsi qu'on aligne à droite le sous-total, les taxes et le total. Les éditeurs et les moteurs de rendu Markdown masquent simplement ces commentaires, et votre source reste lisible.

Pensée pour les agents

Les agents écrivent désormais la majorité du Markdown, alors nous avons rendu l'API facile à utiliser pour eux. Le site publie un fichier llms.txt et une spécification OpenAPI, et la page d'accueil offre un bouton « Copy prompt for your agent ». Collez ce texte dans Claude, ChatGPT, Cursor ou tout agent capable de faire une requête HTTP, et il pourra vous remettre un PDF plutôt qu'un mur de Markdown.

Les instructions demandent aussi à l'agent de vous demander une fois comment vous voulez que vos documents soient présentés, puis d'enregistrer ces options pour que chaque document qu'il produit ait la même allure.

Gratuit, avec usage raisonnable

Il n'y a aucun forfait payant derrière. Les seules limites servent à garder le service en bonne santé pour tout le monde:

• 30 documents par minute par adresse IP
• 512 Kio de Markdown par document
• 20 images distantes par document

Nous ne conservons pas vos documents. Votre Markdown est rendu en mémoire et jeté avec la réponse, et les images sont récupérées pour cette seule requête. Seuls les polices et les logos sont mis en cache, parce qu'ils reviennent d'une requête à l'autre.

Quand il vous faut plus que du Markdown

Le Markdown vers PDF est le cas le plus simple d'une chose que nous faisons chaque jour: transformer des données en documents. Quand le document est un contrat bâti à partir d'un gabarit, un formulaire gouvernemental à remplir ou un PDF à faire signer, l'API CloudRaker s'en occupe aussi. Compose remplit des gabarits, fill complète des formulaires PDF existants, et Rakesign recueille des signatures juridiquement valides. Vous pouvez aussi aller dans l'autre sens, avec l'extraction, la lecture et la classification des documents qui arrivent.

Essayez-la dès maintenant sur markdowntopdf.dev. Choisissez un exemple, changez la police et téléchargez le PDF.