API-Dokumentation
Konvertieren Sie Markdown programmatisch in PDF. Unsere REST API ermöglicht Ihnen die Erstellung professioneller, gestalteter PDFs aus Markdown-Inhalten mit einer einzigen HTTP-Anfrage.
Schnellstart
Erstellen Sie ein PDF in 30 Sekunden mit einem einfachen curl-Befehl.
API-Schlüssel abrufen
Generieren Sie einen Schlüssel aus Ihrem Dashboard unter API Keys.
Markdown schreiben
Jedes gültige Markdown wird unterstützt — Überschriften, Listen, Codeblöcke, Tabellen, Bilder.
Anfrage stellen
Senden Sie eine POST-Anfrage mit Ihrem Schlüssel und Markdown. Sie erhalten ein PDF zurück.
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.pdfAuthentifizierung
apiDocs.authentication.description
Anfrage-Header
| Header | Wert | Beschreibung |
|---|---|---|
| Authorization | Bearer mp_live_... | Ihr API-Schlüssel mit Bearer-Präfix |
| Content-Type | application/json | Erforderlich für alle Anfragen |
apiDocs.authentication.keyFormat
POST /api/v1/convert
Konvertieren Sie Markdown in ein gestaltetes PDF-Dokument.
Anfragekörper
markdownstringErforderlichDer zu konvertierende Markdown-Inhalt. Maximal 200.000 Zeichen.
templateIdstringOptionalZu verwendende Vorlage. Eine von: clean, executive, resume, academic, legal, creative. Standard: clean.
filenamestringOptionalName der heruntergeladenen PDF-Datei. Standard: document.pdf.
localestringOptionalGebietsschema für die Darstellung. Eine von: en, es, fr, de, ja, zh-CN, ko, pt-BR, ar, ru, hi, it. Standard: en.
customTemplateIdUUIDOptionalUUID einer gespeicherten benutzerdefinierten Vorlage. Die Vorlage muss dem Benutzer des API-Schlüssels gehören.
optionsobjectOptionalKonvertierungsoptionen: pageNumbers (boolean), bodyTextColor (hex), headingTextColor (hex), creativeAccent (slate|purple|blue|emerald|rose|amber).
Beispielanfragen
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();Vorlagen
Wählen Sie aus sechs professionell gestalteten Vorlagen. Jede Vorlage hat unterschiedliche Typografie, Abstände und Farbschemata.
Clean
Minimalistisches, modernes serifenloses Design mit sauberen Abständen.
Executive
Serifen-Überschriften mit professionellen marineblauen Akzenten und Seitenzahlen.
Resume
Kompaktes einspaltiges Layout, optimiert für Lebensläufe.
Academic
Nummerierte Überschriften, großzügige Abstände und EB Garamond-Schrift.
Legal
Zweizeiliger Serifen-Text mit formeller Zitierformatierung.
Creative
Fette DM Sans-Überschriften mit konfigurierbaren Akzentfarben.
Fehlercodes
Jede Antwort verwendet einen standardmäßigen HTTP-Statuscode. Nutzen Sie ihn, um zu entscheiden, wie das Ergebnis behandelt wird.
| Status | Bedeutung | Aktion |
|---|---|---|
| 200 | Erfolg — PDF zurückgegeben | Laden Sie das PDF aus dem Antwortkörper herunter. |
| 400 | Ungültiger Anfragekörper | Prüfen Sie, ob Ihr JSON-Payload mit dem obigen Schema übereinstimmt. |
| 401 | Ungültiger oder fehlender API-Schlüssel | Stellen Sie sicher, dass Ihr API-Schlüssel aktiv und korrekt formatiert ist. |
| 402 | API-Guthaben aufgebraucht | Kaufen Sie weiteres Guthaben in Ihrem Dashboard. |
| 404 | Benutzerdefinierte Vorlage nicht gefunden | Prüfen Sie, ob die customTemplateId korrekt ist und Ihnen gehört. |
| 415 | Falscher Content-Type | Setzen Sie den Content-Type-Header auf application/json. |
| 422 | Ungültige Konvertierungsoptionen | Prüfen Sie, ob Ihr options-Objekt der Spezifikation entspricht. |
| 429 | Ratenbegrenzung erreicht | Warten Sie und wiederholen Sie es. Prüfen Sie den Retry-After-Header. |
| 500 | Serverfehler | Wiederholen Sie mit exponentiellem Backoff. Kontaktieren Sie den Support bei anhaltenden Problemen. |
API-Preise
API-Aufrufe werden monatlich erfasst. Jede erfolgreiche Konvertierung zählt zum monatlichen Limit Ihres Tarifs.
$0
25 / month
Zum Testen und Bewerten.
$9
500 / month
Für Einzelpersonen und kleine Projekte.
$29
1,000 / month
Priorisierte Generierung, Unterstützung für benutzerdefinierte Vorlagen per API.
Sie brauchen mehr? Kontaktieren Sie uns für individuelle Unternehmenspreise.