MarkdownCo
API Développeur

API Markdown Converter pour développeurs

Convertissez du Markdown, PDF, Word et HTML par programmation avec un seul endpoint REST. Rendu complet des équations LaTeX et des diagrammes Mermaid, hébergé et prêt à appeler depuis n'importe quel langage. Obtenez une clé API sur RapidAPI et commencez à convertir en quelques minutes.

Démarrage rapide de l'API de conversion Markdown

Deux appels : soumettez un fichier pour obtenir un identifiant de tâche, puis interrogez l'API pour récupérer l'URL de téléchargement. Tous les endpoints suivent le même schéma.

# 1. Submit a Markdown file for PDF conversion
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/md-to-pdf" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
  -F "source_file=@README.md"
# -> { "task_id": "550e8400-...", "status": "processing" }

# 2. Poll for the result until status is "completed"
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/query-task" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
  -d "task_id=550e8400-..."
# -> { "status": "completed", "to_url": "https://.../README.pdf" }

1. Soumettre une conversion

Envoyez un fichier (source_file) ou l'URL publique d'un fichier (source_file_url). L'API vous retourne un task_id.

2. Interroger l'API pour récupérer le résultat

Appelez query-task avec le task_id jusqu'à ce que le statut soit completed, puis téléchargez le fichier depuis to_url.

Remplacez YOUR_RAPIDAPI_KEY par la clé disponible dans votre tableau de bord RapidAPI. La valeur de X-RapidAPI-Host y est également indiquée.

Endpoints de l'API Markdown vers PDF, Word et HTML

Tous les endpoints acceptent POST avec multipart/form-data et retournent un task_id. Chemin de base : /apix.

MéthodeEndpointDescriptionOutil en ligne
POST/apix/md-to-pdfConvertit du Markdown en PDF, avec rendu LaTeX et Mermaid.Essayer en ligne
POST/apix/md-to-docxConvertit du Markdown en document Word (.docx) modifiable.Essayer en ligne
POST/apix/md-to-htmlConvertit du Markdown en HTML propre et sémantique.Essayer en ligne
POST/apix/pdf-to-mdExtrait du Markdown depuis un PDF, y compris le texte, les tableaux et les images.Essayer en ligne
POST/apix/docx-to-mdConvertit un document Word (.docx) en Markdown.Essayer en ligne
POST/apix/html-to-mdConvertit une page ou un fragment HTML en Markdown propre.Essayer en ligne
POST/apix/query-taskInterroge une tâche par task_id et récupère l'URL de téléchargement dès qu'elle est disponible.

Fonctionnement de l'API de conversion asynchrone

Les conversions s'exécutent de manière asynchrone, ainsi les fichiers volumineux ne bloquent jamais votre requête.

Soumission

Envoyez en POST votre fichier Markdown, PDF, Word ou HTML — en upload direct ou via une URL publique — vers l'endpoint correspondant.

Réception de l'identifiant de tâche

L'API retourne immédiatement un task_id avec le statut processing. Aucune connexion maintenue ouverte.

Interrogation et téléchargement

Appelez query-task avec le task_id. Lorsque le statut est completed, téléchargez le fichier depuis to_url retourné dans la réponse.

Ce que l'API Markdown Converter est capable de rendre

Des équations LaTeX aux diagrammes Mermaid, l'API transforme du Markdown complexe en PDF, Word et HTML propres, sans perte de fidélité.

Équations LaTeX

Les équations LaTeX inline et en bloc sont rendues fidèlement dans les sorties PDF et Word — idéal pour les documents académiques et techniques.

Diagrammes Mermaid

Les organigrammes, diagrammes de séquence, diagrammes de Gantt et diagrammes de classes écrits en Mermaid sont rendus sous forme de véritables graphiques.

Support complet GFM

Tableaux en pipe, listes de tâches, blocs de code délimités avec coloration syntaxique, texte barré et liens automatiques — tout est préservé.

Bidirectionnel

Convertissez du Markdown vers PDF, Word et HTML — ou convertissez ces formats en Markdown propre pour la gestion de versions.

Cas d'usage de l'API de conversion Markdown

Les développeurs utilisent l'API pour générer des documents automatiquement — dans des pipelines de build, des fonctionnalités produit et des traitements en lot.

Pipelines CI/CD

Générez des notes de version, des rapports ou des artifacts PDF à partir de Markdown à chaque build, sans navigateur headless à maintenir.

Outillage de documentation

Transformez automatiquement vos docs Markdown en PDF ou Word téléchargeables pour vos utilisateurs, clients et lecture hors ligne.

Conversion en lot

Traitez de grands volumes de documents côté serveur en passant des URL de fichiers publics, puis récupérez les résultats par identifiant de tâche.

Tarifs de l'API Markdown Converter

L'API est facturée à l'usage via RapidAPI avec un niveau gratuit pour démarrer et des plans payants qui s'adaptent à votre volume. La facturation, les clés et les limites de débit sont gérés dans votre compte RapidAPI.

Basic

$0 / mois

30

requêtes / mois

Pro

$7.90 / mois

800

requêtes / mois

+ $0.02 / request

Recommandé

Ultra

$24.90 / mois

4,000

requêtes / mois

+ $0.012 / request

Mega

$49.90 / mois

12,000

requêtes / mois

+ $0.008 / request

Les quotas et les prix sont définis sur RapidAPI et peuvent évoluer — consultez les plans en cours pour les détails à jour.

Voir les plans sur RapidAPI

FAQ sur l'intégration de l'API Markdown

Tout ce qu'un développeur qui débute a besoin de savoir pour s'abonner, s'authentifier, envoyer des requêtes et choisir un plan pour l'API de conversion Markdown.

Comment démarrer avec l'API de conversion Markdown ?

Créez un compte RapidAPI gratuit, ouvrez l'API Markdown Converter Pro dans le RapidAPI Hub et abonnez-vous à un plan — le plan Basic est gratuit. Une fois abonné, vous pouvez appeler n'importe quel endpoint immédiatement en utilisant les exemples de code ci-dessus.

Où trouver ma clé API ?

Après votre abonnement, RapidAPI génère une clé API personnelle pour votre compte. Vous la trouverez dans votre tableau de bord RapidAPI et dans l'onglet Code Snippets de chaque endpoint. Envoyez-la à chaque requête via l'en-tête X-RapidAPI-Key, accompagnée de l'en-tête X-RapidAPI-Host indiqué à côté.

Quelles conversions l'API prend-elle en charge ?

L'API dispose de six endpoints de conversion — Markdown vers PDF, Word et HTML, ainsi que l'inverse depuis PDF, Word et HTML vers Markdown — et d'un endpoint query-task pour récupérer les résultats. Le tableau des endpoints ci-dessus liste le chemin exact de chacun.

Quels paramètres une requête de conversion nécessite-t-elle ?

Chaque endpoint de conversion attend une requête multipart/form-data avec l'un de ces deux champs : source_file pour envoyer un fichier directement, ou source_file_url pour pointer vers un fichier accessible publiquement. Utilisez l'un ou l'autre — si les deux sont fournis, source_file est prioritaire. Les fichiers peuvent peser jusqu'à 50 MB, et le type de fichier doit correspondre à l'endpoint : md-to-pdf attend un fichier .md.

Comment récupérer le fichier converti ?

Les conversions s'exécutent de manière asynchrone : une requête réussie retourne donc un task_id plutôt que le fichier lui-même. Transmettez ce task_id à l'endpoint query-task et continuez à interroger l'API jusqu'à ce que le statut soit completed, puis téléchargez le fichier final depuis to_url dans la réponse.

Que se passe-t-il lorsqu'une conversion échoue ?

Si une conversion ne peut pas aboutir, query-task retourne un statut failed au lieu de completed. Les causes les plus fréquentes sont un type de fichier qui ne correspond pas à l'endpoint, une source_file_url non accessible publiquement, ou un fichier dépassant 50 MB. Corrigez la saisie et soumettez à nouveau la requête.

Quel plan tarifaire choisir ?

Commencez par le plan gratuit Basic pour tester votre intégration, puis montez en gamme vers un plan payant au fur et à mesure que votre volume mensuel de requêtes augmente. Chaque plan inclut un quota mensuel de requêtes et facture un faible coût unitaire au-delà — le tableau de tarification ci-dessus présente les niveaux actuels. La facturation et les limites sont gérées dans votre compte RapidAPI.

Que devient mes fichiers après la conversion ?

Vos fichiers ne sont pas conservés. Les documents envoyés et les sorties converties sont traités temporairement puis supprimés, et les fichiers finalisés sont servis depuis une URL de téléchargement à durée de vie limitée plutôt qu'être stockés durablement.

Commencez à convertir en quelques minutes

Abonnez-vous sur RapidAPI, récupérez votre clé et effectuez votre premier appel de conversion dès aujourd'hui.

Démarrer sur RapidAPI