Novo na API? Ver casos de uso e preços →

API reference

Documentação da API

Converta Markdown em belas imagens de forma programática. Comece com 50 solicitações gratuitas por mês.

Inicio rapido

Criar um token de API

Faca login e crie um token na sua pagina de tokens de API

Faca sua primeira chamada de API

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

Autenticacao

Todas as solicitacoes de API (exceto gerenciamento de tokens) exigem um token Bearer no cabecalho Authorization. Obtenha seu token na pagina Perfil > Tokens de API.

Authorization: Bearer mti_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Limites e cota

Solicitacoes gratuitas por mes

A cota gratuita da API inclui marca d'agua

Credito por solicitacao adicional

1 credito remove a marca d'agua

A cota gratuita da API sempre inclui marca d'agua, a menos que um credito seja usado. Os creditos de boas-vindas para exportacoes no navegador sao separados: contas autenticadas recebem 5 exportacoes de navegador totais sem marca d'agua. Depois disso, exportacoes do navegador incluem marca d'agua se nao houver creditos disponiveis ou se a remocao nao for selecionada. A API inclui 50 solicitacoes gratuitas com marca d'agua por mes; depois, cada renderizacao API sem marca d'agua usa 1 credito.

Endpoints da API

Converte conteudo Markdown em uma imagem. Retorna uma URL de imagem ou dados binarios dependendo do parametro mode.

Bearer Token

Parameters

markdownstringrequired

O conteudo Markdown a ser convertido em imagem

widthnumberdefault: 800

Largura da imagem em pixels (200-2560)

formatstringdefault: png

Formato de saida: png, jpeg, webp ou pdf. Com pdf, retorna um documento PDF em formato A4 com cabecalho/rodape

qualitynumberdefault: 2.0

Fator de escala do dispositivo para renderizacao (1.0-3.0)

themestring

Tema visual para a imagem renderizada

lightdarknordgithubmonokaisolarized

codeStylestring

Estilo de destaque de sintaxe para blocos de codigo

defaultgithubvsxcodeatom-one-lightgooglecode

fontFamilystring

Familia de fontes para o conteudo renderizado

sansintermodernarticledocsroboto

modestringdefault: url

Modo de resposta: 'url' retorna uma URL de imagem temporária (válida por 24 horas), 'binary' retorna os dados binários. Para armazenamento permanente, baixe a imagem a tempo

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

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

Obter estatisticas de uso mensal da API, incluindo cota gratuita restante e saldo de creditos.

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

Obter o esquema da API em um formato compativel com as definicoes de ferramentas do MCP (Model Context Protocol). Util para integracao de agentes de IA.

Public

Response

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

Codigos de erro

Codigo de erro	HTTP Status	Descricao
UNAUTHORIZED	401	Token de API invalido ou ausente
INVALID_REQUEST	400	Parametros de solicitacao invalidos
MARKDOWN_REQUIRED	400	O conteudo Markdown e obrigatorio
QUOTA_EXCEEDED	429	Cota mensal gratuita excedida e creditos insuficientes
GENERATION_FAILED	500	Falha na geracao da imagem
INTERNAL_ERROR	500	Erro interno do servidor

Popular Integration Patterns

n8n HTTP Request

Use this configuration in n8n's HTTP Request node:

Method: POST
URL: https://markdowntoimage.com/api/v1/images/generate
Headers:
  Authorization: Bearer mti_your_token
  Content-Type: application/json

Body (JSON):
{
  "markdown": "{{ $json.content }}",
  "format": "png",
  "theme": "github-dark"
}

Dify Custom Tool

Add as a custom tool in Dify:

Tool Schema:
{
  "name": "markdown_to_image",
  "description": "Convert markdown to PNG/PDF image",
  "parameters": [
    {
      "name": "markdown",
      "description": "Markdown content to convert",
      "type": "string"
    },
    {
      "name": "format",
      "description": "Output format: png, jpeg, pdf",
      "type": "string"
    }
  ],
  "endpoint": "https://markdowntoimage.com/api/v1/images/generate"
}

Need custom template support?

Our team can help you with custom templates, higher volume integrations, or enterprise implementations.

Request Integration Support

Response time: 1-2 business days