Markdown to PDF
v1.0REST API

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.

1

API-Schlüssel abrufen

Generieren Sie einen Schlüssel aus Ihrem Dashboard unter API Keys.

2

Markdown schreiben

Jedes gültige Markdown wird unterstützt — Überschriften, Listen, Codeblöcke, Tabellen, Bilder.

3

Anfrage stellen

Senden Sie eine POST-Anfrage mit Ihrem Schlüssel und Markdown. Sie erhalten ein PDF zurück.

cURL
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.pdf

Authentifizierung

apiDocs.authentication.description

Anfrage-Header

HeaderWertBeschreibung
AuthorizationBearer mp_live_...Ihr API-Schlüssel mit Bearer-Präfix
Content-Typeapplication/jsonErforderlich für alle Anfragen

apiDocs.authentication.keyFormat


POST /api/v1/convert

Konvertieren Sie Markdown in ein gestaltetes PDF-Dokument.

Anfragekörper

markdownstringErforderlich

Der zu konvertierende Markdown-Inhalt. Maximal 200.000 Zeichen.

templateIdstringOptional

Zu verwendende Vorlage. Eine von: clean, executive, resume, academic, legal, creative. Standard: clean.

filenamestringOptional

Name der heruntergeladenen PDF-Datei. Standard: document.pdf.

localestringOptional

Gebietsschema für die Darstellung. Eine von: en, es, fr, de, ja, zh-CN, ko, pt-BR, ar, ru, hi, it. Standard: en.

customTemplateIdUUIDOptional

UUID einer gespeicherten benutzerdefinierten Vorlage. Die Vorlage muss dem Benutzer des API-Schlüssels gehören.

optionsobjectOptional

Konvertierungsoptionen: pageNumbers (boolean), bodyTextColor (hex), headingTextColor (hex), creativeAccent (slate|purple|blue|emerald|rose|amber).

Beispielanfragen

Python
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)
JavaScript
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

Clean

Minimalistisches, modernes serifenloses Design mit sauberen Abständen.

executive

Executive

Serifen-Überschriften mit professionellen marineblauen Akzenten und Seitenzahlen.

resume

Resume

Kompaktes einspaltiges Layout, optimiert für Lebensläufe.

academic

Academic

Nummerierte Überschriften, großzügige Abstände und EB Garamond-Schrift.

legal

Legal

Zweizeiliger Serifen-Text mit formeller Zitierformatierung.

creative

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.

StatusBedeutungAktion
200Erfolg — PDF zurückgegebenLaden Sie das PDF aus dem Antwortkörper herunter.
400Ungültiger AnfragekörperPrüfen Sie, ob Ihr JSON-Payload mit dem obigen Schema übereinstimmt.
401Ungültiger oder fehlender API-SchlüsselStellen Sie sicher, dass Ihr API-Schlüssel aktiv und korrekt formatiert ist.
402API-Guthaben aufgebrauchtKaufen Sie weiteres Guthaben in Ihrem Dashboard.
404Benutzerdefinierte Vorlage nicht gefundenPrüfen Sie, ob die customTemplateId korrekt ist und Ihnen gehört.
415Falscher Content-TypeSetzen Sie den Content-Type-Header auf application/json.
422Ungültige KonvertierungsoptionenPrüfen Sie, ob Ihr options-Objekt der Spezifikation entspricht.
429Ratenbegrenzung erreichtWarten Sie und wiederholen Sie es. Prüfen Sie den Retry-After-Header.
500ServerfehlerWiederholen 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.

Free

$0

25 / month

Zum Testen und Bewerten.

Starter

$9

500 / month

Für Einzelpersonen und kleine Projekte.

Pro

$29

1,000 / month

Priorisierte Generierung, Unterstützung für benutzerdefinierte Vorlagen per API.

Sie brauchen mehr? Kontaktieren Sie uns für individuelle Unternehmenspreise.