Zum Inhalt springen

Entwicklerreferenz

API-Referenz

Token erstellen, Markdown senden und ein gerendertes Bild oder PDF erhalten. Diese Referenz behandelt Requests, Antworten, Kontingente und Workflow-Integrationen.

Schnellstart

1

API-Token erstellen

Melden Sie sich an und erstellen Sie einen Token auf Ihrer API-Token-Seite

2

Ersten API-Aufruf durchführen

curl -X POST https://markdowntoimage.com/api/v1/images/generate \
  -H "Authorization: Bearer mti_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# Hello World\n\nThis is a test."}'

Authentifizierung

Alle API-Anfragen (außer Token-Verwaltung) erfordern einen Bearer-Token im Authorization-Header. Erhalten Sie Ihren Token auf der Seite Profil > API-Tokens.

Authorization: Bearer mti_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Ratenlimits und Kontingente

Kostenlose Anfragen pro Monat
50API-Freikontingent enthält Wasserzeichen
Credit pro zusätzliche Anfrage
11 Credit entfernt das Wasserzeichen

API-Nutzung und Browser-Exporte werden getrennt abgerechnet. Die API enthält monatlich 50 Anfragen mit Wasserzeichen; 1 API-Credit ermöglicht einen Render ohne Wasserzeichen. Ohne Freikontingent oder Credits wird HTTP 429 zurückgegeben. Angemeldete Konten erhalten insgesamt 5 Browser-Exporte ohne Wasserzeichen. Danach gelten Abonnements, Einmalpässe für 1 US-Dollar oder geeignete ältere Credits. Neue API-Credits entfernen keine Browser-Wasserzeichen.

Endpunkte

Konvertiert Markdown-Inhalte in ein Bild. Gibt je nach mode-Parameter eine Bild-URL oder Binärdaten zurück.

Bearer-Token erforderlich

Parameter

markdownstringErforderlich
Der Markdown-Inhalt, der in ein Bild konvertiert werden soll
widthnumberStandard: 800
Bildbreite in Pixeln (200-2560)
formatstringStandard: png
Ausgabeformat: png, jpeg, webp oder pdf. Bei pdf wird ein A4-formatiertes PDF-Dokument mit Kopf-/Fusszeile zuruckgegeben
qualitynumberStandard: 2.0
Geräteskalierungsfaktor für das Rendering (1.0-3.0)
themestring
Visuelles Thema für das gerenderte Bild
lightdarknordgithubmonokaisolarized
codeStylestring
Syntaxhervorhebungsstil für Codeblöcke
defaultgithubvsxcodeatom-one-lightgooglecode
fontFamilystring
Schriftfamilie für den gerenderten Inhalt
sansintermodernarticledocsroboto
modestringStandard: url
Antwortmodus: 'url' gibt eine temporäre Bild-URL zurück (24 Stunden gültig), 'binary' gibt rohe Bilddaten zurück. Für dauerhafte Speicherung laden Sie das Bild bitte rechtzeitig herunter
curl -X POST https://markdowntoimage.com/api/v1/images/generate \
  -H "Authorization: Bearer mti_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "# Hello\n\n- Item 1\n- Item 2",
    "width": 800,
    "format": "png",
    "theme": "github-dark"
  }'

Antwort

{
  "success": true,
  "data": {
    "imageUrl": "https://markdowntoimage.com/api-temp/uuid.png",
    "imageId": "550e8400-e29b-41d4-a716-446655440000",
    "format": "png",
    "width": 800
  },
  "meta": {
    "quota": {
      "freeRemaining": 48,
      "creditBalance": 200,
      "usedFreeQuota": true
    }
  }
}

Aktuelle monatliche API-Nutzungsstatistiken abrufen, einschließlich verbleibendem Freikontingent und Credit-Guthaben.

Bearer-Token erforderlich

cURL
curl https://markdowntoimage.com/api/v1/account/usage \
  -H "Authorization: Bearer mti_your_token"

Antwort

{
  "success": true,
  "data": {
    "monthlyQuota": 50,
    "monthlyUsed": 12,
    "monthlyRemaining": 38,
    "yearMonth": "2026-02",
    "creditBalance": 200,
    "resetDate": "2026-03-01"
  }
}

API-Schema in einem mit MCP (Model Context Protocol) Tooldefinitionen kompatiblen Format abrufen. Nützlich für die Integration von KI-Agenten.

Öffentlicher Endpunkt

Antwort

{
  "success": true,
  "data": {
    "name": "markdown-to-image",
    "version": "v1",
    "tools": [...]
  }
}

Fehlercodes

FehlercodeHTTP-StatusBeschreibung
UNAUTHORIZED401Ungültiger oder fehlender API-Token
INVALID_REQUEST400Ungültige Anfrageparameter
MARKDOWN_REQUIRED400Markdown-Inhalt ist erforderlich
QUOTA_EXCEEDED429Monatliches Freikontingent überschritten und unzureichende Credits
GENERATION_FAILED500Bildgenerierung fehlgeschlagen
INTERNAL_ERROR500Interner Serverfehler

Workflow-Integrationen

n8n HTTP Request

Methode auf POST setzen, Bearer-Token im Header ergänzen und diesen JSON-Body verwenden. Die Anleitung erklärt die Antwortverarbeitung.

JSON
{
  "markdown": "={{ $json.content }}",
  "format": "png",
  "mode": "url"
}

Dify Custom Tool

Diese OpenAPI-URL unter Tools → Custom importieren, dann Bearer-Authentifizierung mit Ihrem API-Token einrichten.

OpenAPI
https://markdowntoimage.com/api/v1/openapi.json

Weitere Integrationen

Unterstützung für eigene Vorlagen?

Eigene Vorlagen, höhere Rendering-Volumen oder HTTP-API-Integration mit unserem Team besprechen.

Integration besprechen

Wir antworten in der Regel innerhalb von 1–2 Werktagen.

Markdown To Image | Effortlessly Convert Markdown to PDF, JPEG, PNG, and WebP with markdowntoimage.com