Documentation API
Convertissez Markdown en PDF par programmation. Notre REST API vous permet de générer des PDF professionnels et stylés à partir de contenu Markdown avec une seule requête HTTP.
Démarrage rapide
Générez un PDF en 30 secondes avec une simple commande curl.
Obtenez votre clé API
Générez une clé depuis votre tableau de bord sous API Keys.
Écrivez du Markdown
Tout Markdown valide est pris en charge — titres, listes, blocs de code, tableaux, images.
Effectuez la requête
Envoyez une requête POST avec votre clé et le Markdown. Recevez un PDF en retour.
curl -X POST https://markdowntopdfconverter.com/api/v1/convert \
-H "Authorization: Bearer mp_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"markdown": "# Hello World\n\nThis is a **test**.", "templateId": "clean"}' \
-o output.pdfAuthentification
apiDocs.authentication.description
En-tête de requête
| En-tête | Valeur | Description |
|---|---|---|
| Authorization | Bearer mp_live_... | Votre clé API préfixée par Bearer |
| Content-Type | application/json | Requis pour toutes les requêtes |
apiDocs.authentication.keyFormat
POST /api/v1/convert
Convertissez Markdown en un document PDF stylé.
Corps de la requête
markdownstringRequisLe contenu Markdown à convertir. Maximum 200 000 caractères.
templateIdstringOptionnelModèle à utiliser. Un de : clean, executive, resume, academic, legal, creative. Par défaut : clean.
filenamestringOptionnelNom du fichier PDF téléchargé. Par défaut : document.pdf.
localestringOptionnelParamètre régional. Un de : en, es, fr, de, ja, zh-CN, ko, pt-BR, ar, ru, hi, it. Par défaut : en.
customTemplateIdUUIDOptionnelUUID d’un modèle personnalisé sauvegardé. Le modèle doit appartenir à l’utilisateur de la clé API.
optionsobjectOptionnelOptions de conversion : pageNumbers (boolean), bodyTextColor (hex), headingTextColor (hex), creativeAccent (slate|purple|blue|emerald|rose|amber).
Exemples de requêtes
import requests
api_key = "mp_live_your_api_key_here"
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
payload = {
"markdown": "# Quarterly Report\n\n## Revenue\n\nRevenue grew **15%** this quarter.",
"templateId": "executive",
"options": {"pageNumbers": True}
}
response = requests.post(
"https://markdowntopdfconverter.com/api/v1/convert",
json=payload,
headers=headers
)
with open("report.pdf", "wb") as f:
f.write(response.content)const response = await fetch(
"https://markdowntopdfconverter.com/api/v1/convert",
{
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
markdown: "# Invoice\n\n**Amount:** $1,200\n\n| Item | Qty | Price |\n| --- | --- | --- |\n| Widget | 5 | $240 |",
templateId: "clean",
filename: "invoice",
}),
}
);
const blob = await response.blob();
const url = URL.createObjectURL(blob);
// Trigger download
const a = document.createElement("a");
a.href = url;
a.download = "invoice.pdf";
a.click();Modèles
Choisissez parmi six modèles conçus professionnellement. Chaque modèle a une typographie, un espacement et des schémas de couleurs distincts.
Clean
Design minimaliste et moderne sans empattement avec un espacement propre.
Executive
Titres avec empattement, accents marine professionnels et numéros de page.
Resume
Mise en page compacte sur une colonne optimisée pour les CV.
Academic
Titres numérotés, espacement généreux et corps EB Garamond.
Legal
Corps avec empattement à double interligne avec formatage de citations formel.
Creative
Titres DM Sans en gras avec couleurs d’accent configurables.
Codes d’erreur
Chaque réponse utilise un code d’état HTTP standard. Utilisez-le pour décider comment traiter le résultat.
| Statut | Signification | Action |
|---|---|---|
| 200 | Succès — PDF retourné | Téléchargez le PDF depuis le corps de la réponse. |
| 400 | Corps de requête invalide | Vérifiez que votre charge JSON correspond au schéma ci-dessus. |
| 401 | Clé API invalide ou manquante | Vérifiez que votre clé API est active et correctement formatée. |
| 402 | Crédits API épuisés | Achetez plus de crédits depuis votre tableau de bord. |
| 404 | Modèle personnalisé introuvable | Vérifiez que customTemplateId est correct et vous appartient. |
| 415 | Mauvais Content-Type | Définissez l’en-tête Content-Type sur application/json. |
| 422 | Options de conversion invalides | Vérifiez que votre objet options correspond aux spécifications. |
| 429 | Limite de débit atteinte | Attendez et réessayez. Vérifiez l’en-tête Retry-After. |
| 500 | Erreur serveur | Réessayez avec un backoff exponentiel. Contactez le support si persistant. |
Tarifs API
Les appels API sont suivis mensuellement. Chaque conversion réussie compte pour la limite mensuelle de votre niveau.
$0
25 / month
Pour les tests et l’évaluation.
$9
500 / month
Pour les particuliers et les petits projets.
$29
1,000 / month
Génération prioritaire, prise en charge des modèles personnalisés via API.
Besoin de plus ? Contactez-nous pour des tarifs entreprise personnalisés.