API Documentation

Convert Markdown to beautiful images programmatically. Get started with 50 free requests per month.

Quick Start

Create an API Token

Make your first API call

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."}'

Authentication

All API requests (except token management) require a Bearer token in the Authorization header. Get your token from the Profile > API Tokens page.

Authorization: Bearer mti_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Rate Limits & Quota

Free requests per month

With watermark (no credits)

Credit per extra request

No watermark (has credits)

Each account gets 50 free API requests per month. Users with a credit balance always get watermark-free images — including during the free quota. Users without credits get images with a watermark. After the free quota is used, each request costs 1 credit.

API Endpoints

Convert Markdown content to an image. Returns either an image URL or binary data depending on the mode parameter.

Bearer Token

Parameters

markdownstringrequired

The Markdown content to convert to an image

widthnumberdefault: 800

Image width in pixels (200-2560)

formatstringdefault: png

Output format: png, jpeg, or webp

qualitynumberdefault: 2.0

Device scale factor for rendering (1.0-3.0)

themestring

Visual theme for the rendered image

lightdarknordgithubmonokaisolarized

codeStylestring

Syntax highlighting style for code blocks

defaultgithubvsxcodeatom-one-lightgooglecode

fontFamilystring

Font family for the rendered content

sansintermodernarticledocsroboto

modestringdefault: url

Response mode: 'url' returns a temporary image URL (retained for 24 hours), 'binary' returns raw image data. For permanent storage, please download the image promptly

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
    }
  }
}

Get current monthly API usage statistics including free quota remaining and credit balance.

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

Get the API schema in a format compatible with MCP (Model Context Protocol) tool definitions. Useful for AI agent integration.

Bearer Token

Response

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

Error Codes

Error Code	HTTP Status	Description
UNAUTHORIZED	401	Invalid or missing API token
INVALID_REQUEST	400	Invalid request parameters
MARKDOWN_REQUIRED	400	Markdown content is required
QUOTA_EXCEEDED	429	Monthly free quota exceeded and insufficient credits
GENERATION_FAILED	500	Image generation failed
INTERNAL_ERROR	500	Internal server error