¿Nuevo en la API? Ver casos de uso y precios →

API reference

Documentación de la API

Convierte Markdown en imágenes atractivas de forma programática. Comienza con 50 solicitudes gratuitas al mes.

Inicio rápido

Crear un token de API

Inicia sesión y crea un token desde tu página de tokens de API

Realiza tu primera llamada a la 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."}'

Autenticación

Todas las solicitudes de API (excepto la gestión de tokens) requieren un token Bearer en el encabezado Authorization. Obtén tu token en la página Perfil > Tokens de API.

Authorization: Bearer mti_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Límites y cuota

Solicitudes gratuitas al mes

La cuota gratuita de API incluye marca de agua

Crédito por solicitud adicional

1 crédito quita la marca de agua

La cuota gratuita de API siempre incluye marca de agua salvo que se use un crédito. Los créditos de bienvenida para exportaciones en el navegador se calculan aparte: las cuentas con sesión iniciada reciben 5 exportaciones de navegador totales sin marca de agua. Después, las exportaciones del navegador incluyen marca de agua si no hay créditos disponibles o no se selecciona quitarla. La API incluye 50 solicitudes gratuitas con marca de agua al mes; después, cada render API sin marca de agua usa 1 crédito.

Endpoints de la API

Convierte contenido Markdown en una imagen. Devuelve una URL de imagen o datos binarios según el parámetro mode.

Bearer Token

Parameters

markdownstringrequired

El contenido Markdown a convertir en imagen

widthnumberdefault: 800

Ancho de la imagen en píxeles (200-2560)

formatstringdefault: png

Formato de salida: png, jpeg, webp o pdf. Con pdf se devuelve un documento PDF en formato A4 con encabezado/pie de pagina

qualitynumberdefault: 2.0

Factor de escala del dispositivo para el renderizado (1.0-3.0)

themestring

Tema visual para la imagen renderizada

lightdarknordgithubmonokaisolarized

codeStylestring

Estilo de resaltado de sintaxis para bloques de código

defaultgithubvsxcodeatom-one-lightgooglecode

fontFamilystring

Familia tipográfica para el contenido renderizado

sansintermodernarticledocsroboto

modestringdefault: url

Modo de respuesta: 'url' devuelve una URL de imagen temporal (válida por 24 horas), 'binary' devuelve los datos binarios. Para almacenamiento permanente, descargue la imagen a tiempo

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

Obtener las estadísticas de uso mensual de la API, incluyendo la cuota gratuita restante y el saldo de créditos.

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

Obtener el esquema de la API en un formato compatible con las definiciones de herramientas de MCP (Model Context Protocol). Útil para la integración de agentes de IA.

Public

Response

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

Códigos de error

Código de error	HTTP Status	Descripción
UNAUTHORIZED	401	Token de API inválido o ausente
INVALID_REQUEST	400	Parámetros de solicitud inválidos
MARKDOWN_REQUIRED	400	El contenido Markdown es obligatorio
QUOTA_EXCEEDED	429	Cuota mensual gratuita excedida y créditos insuficientes
GENERATION_FAILED	500	Error en la generación de la imagen
INTERNAL_ERROR	500	Error interno del 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