API-Dokumentation

Konvertieren Sie Markdown programmgesteuert in ansprechende Bilder. Starten Sie mit 50 kostenlosen Anfragen pro Monat.

Schnellstart

API-Token erstellen

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

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 & Kontingent

Kostenlose Anfragen pro Monat

Mit Wasserzeichen (ohne Credits)

Credit pro zusätzliche Anfrage

Ohne Wasserzeichen (mit Credits)

Jedes Konto erhält 50 kostenlose API-Anfragen pro Monat. Nutzer mit Credit-Guthaben erhalten immer Bilder ohne Wasserzeichen — auch innerhalb des kostenlosen Kontingents. Nutzer ohne Credits erhalten Bilder mit Wasserzeichen. Nach Aufbrauch des Kontingents kostet jede Anfrage 1 Credit.

API-Endpunkte

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

Bearer Token

Parameters

markdownstringrequired

Der Markdown-Inhalt, der in ein Bild konvertiert werden soll

widthnumberdefault: 800

Bildbreite in Pixeln (200-2560)

formatstringdefault: png

Ausgabeformat: png, jpeg oder webp

qualitynumberdefault: 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

modestringdefault: 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": "minimal-dark"
  }'

Response

{
  "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

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

Response

{
  "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.

Bearer Token

Response

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

Fehlercodes

Fehlercode	HTTP Status	Beschreibung
UNAUTHORIZED	401	Ungültiger oder fehlender API-Token
INVALID_REQUEST	400	Ungültige Anfrageparameter
MARKDOWN_REQUIRED	400	Markdown-Inhalt ist erforderlich
QUOTA_EXCEEDED	429	Monatliches Freikontingent überschritten und unzureichende Credits
GENERATION_FAILED	500	Bildgenerierung fehlgeschlagen
INTERNAL_ERROR	500	Interner Serverfehler