Markdown Converter API für Entwickler
Markdown, PDF, Word und HTML programmatisch über einen einzigen REST-Endpunkt konvertieren. Vollständiges LaTeX-Math- und Mermaid-Diagramm-Rendering, gehostet und aus jeder Sprache heraus abrufbar. API-Schlüssel auf RapidAPI besorgen und in wenigen Minuten mit der Konvertierung beginnen.
Markdown Conversion API – Schnellstart
Zwei Aufrufe: Datei einreichen und eine Task-ID erhalten, dann das Ergebnis per Polling abrufen. Alle Endpunkte folgen demselben Muster.
# 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. Konvertierung einreichen
Datei-Upload (source_file) oder öffentliche Datei-URL (source_file_url) senden. Als Antwort erhalten Sie eine task_id.
2. Ergebnis per Polling abrufen
query-task mit der task_id aufrufen, bis der Status completed ist, und die Datei dann von to_url herunterladen.
Markdown zu PDF, Word & HTML – API-Endpunkte
Alle Endpunkte akzeptieren POST mit multipart/form-data und geben eine task_id zurück. Basispfad: /apix.
| Methode | Endpunkt | Beschreibung | Online-Tool |
|---|---|---|---|
| POST | /apix/md-to-pdf | Markdown in PDF konvertieren, mit gerendertem LaTeX und Mermaid. | Online testen |
| POST | /apix/md-to-docx | Markdown in ein bearbeitbares Word-Dokument (.docx) konvertieren. | Online testen |
| POST | /apix/md-to-html | Markdown in sauberes, semantisches HTML konvertieren. | Online testen |
| POST | /apix/pdf-to-md | Markdown aus einem PDF extrahieren – inklusive Text, Tabellen und Bilder. | Online testen |
| POST | /apix/docx-to-md | Word-Dokument (.docx) in Markdown konvertieren. | Online testen |
| POST | /apix/html-to-md | HTML-Seite oder -Fragment in sauberes Markdown konvertieren. | Online testen |
| POST | /apix/query-task | Task per task_id abfragen und die Download-URL abrufen, sobald das Ergebnis bereitsteht. | — |
So funktioniert die asynchrone Konvertierungs-API
Konvertierungen laufen asynchron, sodass große Dateien Ihre Anfrage nie blockieren.
Einreichen
Markdown-, PDF-, Word- oder HTML-Datei per POST – als Upload oder öffentliche URL – an den passenden Endpunkt senden.
Task-ID empfangen
Die API gibt sofort eine task_id mit dem Status processing zurück. Keine lang offenen Verbindungen.
Pollen & herunterladen
query-task mit der task_id aufrufen. Sobald der Status completed ist, die fertige Datei von der zurückgegebenen to_url herunterladen.
Was die Markdown Converter API rendert
Von LaTeX-Gleichungen bis hin zu Mermaid-Diagrammen – die API wandelt komplexes Markdown verlustfrei in sauberes PDF, Word und HTML um.
LaTeX-Mathematik
Inline- und Block-LaTeX-Gleichungen werden in PDF- und Word-Ausgaben präzise gerendert – ideal für wissenschaftliche und technische Dokumente.
Mermaid-Diagramme
Flussdiagramme, Sequenzdiagramme, Gantt-Charts und Klassendiagramme in Mermaid werden als echte Grafiken gerendert.
Vollständige GFM-Unterstützung
Pipe-Tabellen, Aufgabenlisten, umrandete Code-Blöcke mit Syntax-Highlighting, Durchstreichungen und Auto-Links – alles wird korrekt übernommen.
Bidirektional
Aus Markdown in PDF, Word und HTML konvertieren – oder diese Formate für die Versionsverwaltung zurück in sauberes Markdown umwandeln.
Anwendungsfälle der Markdown Conversion API
Entwickler nutzen die API, um Dokumente automatisch zu generieren – in Build-Pipelines, Produktfeatures und Massenverarbeitungen.
CI/CD-Pipelines
Release-Notes, Berichte oder PDF-Artefakte aus Markdown bei jedem Build generieren – ganz ohne headless Browser zur Pflege.
Dokumentations-Tooling
Markdown-Dokumentation automatisch in herunterladbare PDF- oder Word-Dateien für Nutzer, Kunden und die Offline-Nutzung umwandeln.
Massenkonvertierung
Große Dokumentenmengen serverseitig verarbeiten, indem öffentliche Datei-URLs übergeben und die Ergebnisse per Task-ID eingesammelt werden.
Markdown Converter API – Preise
Die API wird über RapidAPI abgerechnet: mit einem kostenlosen Einstiegskontingent und kostenpflichtigen Tarifen, die mit Ihrer Nutzung skalieren. Abrechnung, Schlüssel und Rate-Limits werden vollständig in Ihrem RapidAPI-Konto verwaltet.
Basic
30
Anfragen / Monat
Pro
800
Anfragen / Monat
+ $0.02 / request
Ultra
4,000
Anfragen / Monat
+ $0.012 / request
Mega
12,000
Anfragen / Monat
+ $0.008 / request
Kontingente und Preise werden auf RapidAPI festgelegt und können sich ändern – aktuelle Details entnehmen Sie den Live-Tarifen.
Tarife auf RapidAPI ansehenFAQ zur Markdown API-Integration
Alles, was Entwickler beim Einstieg wissen müssen: Abonnieren, Authentifizieren, Anfragen senden und den richtigen Tarif für die Markdown Conversion API wählen.
Wie fange ich mit der Markdown Conversion API an?
Kostenloses RapidAPI-Konto anlegen, die Markdown Converter Pro API im RapidAPI Hub öffnen und einen Tarif abonnieren – der Basic-Tarif ist kostenlos. Nach dem Abonnement können Sie jeden Endpunkt sofort mit den obigen Code-Beispielen aufrufen.
Wo finde ich meinen API-Schlüssel?
Nach dem Abonnement stellt RapidAPI einen persönlichen API-Schlüssel für Ihr Konto aus. Sie finden ihn in Ihrem RapidAPI-Dashboard sowie im Tab Code Snippets jedes Endpunkts. Senden Sie ihn bei jeder Anfrage als X-RapidAPI-Key-Header, zusammen mit dem daneben angezeigten X-RapidAPI-Host-Header.
Welche Konvertierungen unterstützt die API?
Die API bietet sechs Konvertierungs-Endpunkte – Markdown zu PDF, Word und HTML sowie die Gegenrichtung von PDF, Word und HTML zurück zu Markdown – und einen query-task-Endpunkt zum Abrufen der Ergebnisse. Die Endpunkt-Tabelle oben listet den genauen Pfad für jeden Endpunkt auf.
Welche Parameter benötigt eine Konvertierungsanfrage?
Jeder Konvertierungs-Endpunkt erwartet eine multipart/form-data-Anfrage mit einem von zwei Feldern: source_file zum direkten Hochladen einer Datei oder source_file_url zum Verweisen auf eine öffentlich erreichbare Datei. Nur eines der beiden verwenden – werden beide gesendet, hat source_file Vorrang. Dateien dürfen bis zu 50 MB groß sein, und der Dateityp muss zum Endpunkt passen: md-to-pdf erwartet beispielsweise eine .md-Datei.
Wie erhalte ich die konvertierte Datei?
Konvertierungen laufen asynchron, daher gibt eine erfolgreiche Anfrage eine task_id zurück – nicht die Datei selbst. Diese task_id an den query-task-Endpunkt übergeben und so lange pollen, bis der Status completed ist; die fertige Datei dann von der to_url in der Antwort herunterladen.
Was passiert, wenn eine Konvertierung fehlschlägt?
Kann eine Konvertierung nicht abgeschlossen werden, gibt query-task den Status failed statt completed zurück. Häufige Ursachen sind ein Dateityp, der nicht zum Endpunkt passt, eine source_file_url, die nicht öffentlich erreichbar ist, oder eine Datei, die größer als 50 MB ist. Eingabe korrigieren und die Anfrage erneut senden.
Welchen Tarif soll ich wählen?
Mit dem kostenlosen Basic-Tarif beginnen, um die Integration zu testen, und dann auf einen kostenpflichtigen Tarif wechseln, wenn das monatliche Anfragevolumen wächst. Jeder Tarif enthält ein monatliches Anfragekontingent und berechnet eine geringe Gebühr pro Anfrage darüber hinaus – die Preistabelle oben zeigt die aktuellen Stufen. Abrechnung und Limits werden in Ihrem RapidAPI-Konto verwaltet.
Was geschieht mit meinen Dateien nach der Konvertierung?
Ihre Dateien werden nicht gespeichert. Hochgeladene Dokumente und die konvertierte Ausgabe werden nur vorübergehend verarbeitet und anschließend gelöscht. Fertige Dateien werden über eine kurzlebige Download-URL bereitgestellt und nicht dauerhaft gespeichert.
In wenigen Minuten loslegen
Auf RapidAPI abonnieren, Schlüssel holen und noch heute den ersten Konvertierungsaufruf machen.
Jetzt auf RapidAPI starten