Markdown to PDF
v1.0REST API

Documentación de API

Convierta Markdown a PDF mediante programación. Nuestra REST API le permite generar PDFs profesionales y con estilo a partir de contenido Markdown con una sola solicitud HTTP.

Inicio rápido

Genere un PDF en 30 segundos con un simple comando curl.

1

Obtenga su clave API

Genere una clave desde su panel en API Keys.

2

Escriba Markdown

Se admite cualquier Markdown válido: encabezados, listas, bloques de código, tablas, imágenes.

3

Realice la solicitud

Envie una solicitud POST con su clave y Markdown. Reciba un PDF.

cURL
curl -X POST https://markdowntopdfconverter.com/api/v1/convert \
  -H "Authorization: Bearer mp_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# Hello World\n\nThis is a **test**.", "templateId": "clean"}' \
  -o output.pdf

Autenticación

apiDocs.authentication.description

Encabezado de solicitud

EncabezadoValorDescripción
AuthorizationBearer mp_live_...Su clave API con prefijo Bearer
Content-Typeapplication/jsonRequerido para todas las solicitudes

apiDocs.authentication.keyFormat


POST /api/v1/convert

Convierta Markdown a un documento PDF con estilo.

Cuerpo de la solicitud

markdownstringRequerido

El contenido Markdown a convertir. Máximo 200.000 caracteres.

templateIdstringOpcional

Plantilla a usar. Una de: clean, executive, resume, academic, legal, creative. Predeterminada: clean.

filenamestringOpcional

Nombre del archivo PDF descargado. Predeterminado: document.pdf.

localestringOpcional

Configuración regional. Una de: en, es, fr, de, ja, zh-CN, ko, pt-BR, ar, ru, hi, it. Predeterminado: en.

customTemplateIdUUIDOpcional

UUID de una plantilla personalizada guardada. La plantilla debe pertenecer al usuario de la clave API.

optionsobjectOpcional

Opciones de conversión: pageNumbers (boolean), bodyTextColor (hex), headingTextColor (hex), creativeAccent (slate|purple|blue|emerald|rose|amber).

Ejemplos de solicitudes

Python
import requests

api_key = "mp_live_your_api_key_here"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}
payload = {
    "markdown": "# Quarterly Report\n\n## Revenue\n\nRevenue grew **15%** this quarter.",
    "templateId": "executive",
    "options": {"pageNumbers": True}
}

response = requests.post(
    "https://markdowntopdfconverter.com/api/v1/convert",
    json=payload,
    headers=headers
)

with open("report.pdf", "wb") as f:
    f.write(response.content)
JavaScript
const response = await fetch(
  "https://markdowntopdfconverter.com/api/v1/convert",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${apiKey}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      markdown: "# Invoice\n\n**Amount:** $1,200\n\n| Item | Qty | Price |\n| --- | --- | --- |\n| Widget | 5 | $240 |",
      templateId: "clean",
      filename: "invoice",
    }),
  }
);

const blob = await response.blob();
const url = URL.createObjectURL(blob);

// Trigger download
const a = document.createElement("a");
a.href = url;
a.download = "invoice.pdf";
a.click();

Plantillas

Elija entre seis plantillas diseñadas profesionalmente. Cada plantilla tiene tipografía, espaciado y esquemas de color distintos.

clean

Clean

Diseño minimalista y moderno sin serifa con espaciado limpio.

executive

Executive

Encabezados con serifa con acentos marino profesionales y números de página.

resume

Resume

Diseño compacto de una columna optimizado para currículos.

academic

Academic

Encabezados numerados, espaciado generoso y cuerpo EB Garamond.

legal

Legal

Cuerpo serifa a doble espacio con formato de citas formal.

creative

Creative

Encabezados DM Sans en negrita con colores de acento configurables.


Códigos de error

Cada respuesta utiliza un código de estado HTTP estándar. Úselo para decidir cómo manejar el resultado.

EstadoSignificadoAcción
200Éxito — PDF devueltoDescargue el PDF del cuerpo de la respuesta.
400Cuerpo de solicitud no válidoVerifique que su carga JSON coincida con el esquema anterior.
401Clave API no válida o faltanteVerifique que su clave API esté activa y tenga el formato correcto.
402Créditos API agotadosCompre más créditos desde su panel.
404Plantilla personalizada no encontradaVerifique que customTemplateId sea correcto y le pertenezca.
415Content-Type incorrectoEstablezca el encabezado Content-Type a application/json.
422Opciones de conversión no válidasVerifique que su objeto options coincida con la especificación.
429Límite de tasa alcanzadoEspere y vuelva a intentarlo. Verifique el encabezado Retry-After.
500Error del servidorReintente con retroceso exponencial. Contacte al soporte si persiste.

Precios de API

Las llamadas API se registran mensualmente. Cada conversión exitosa cuenta para el límite mensual de su nivel.

Free

$0

25 / month

Para pruebas y evaluación.

Starter

$9

500 / month

Para individuos y proyectos pequeños.

Pro

$29

1,000 / month

Generación prioritaria, soporte de plantillas personalizadas vía API.

¿Necesita más? Contáctenos para precios empresariales personalizados.