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.
Obtenga su clave API
Genere una clave desde su panel en API Keys.
Escriba Markdown
Se admite cualquier Markdown válido: encabezados, listas, bloques de código, tablas, imágenes.
Realice la solicitud
Envie una solicitud POST con su clave y Markdown. Reciba un PDF.
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.pdfAutenticación
apiDocs.authentication.description
Encabezado de solicitud
| Encabezado | Valor | Descripción |
|---|---|---|
| Authorization | Bearer mp_live_... | Su clave API con prefijo Bearer |
| Content-Type | application/json | Requerido para todas las solicitudes |
apiDocs.authentication.keyFormat
POST /api/v1/convert
Convierta Markdown a un documento PDF con estilo.
Cuerpo de la solicitud
markdownstringRequeridoEl contenido Markdown a convertir. Máximo 200.000 caracteres.
templateIdstringOpcionalPlantilla a usar. Una de: clean, executive, resume, academic, legal, creative. Predeterminada: clean.
filenamestringOpcionalNombre del archivo PDF descargado. Predeterminado: document.pdf.
localestringOpcionalConfiguración regional. Una de: en, es, fr, de, ja, zh-CN, ko, pt-BR, ar, ru, hi, it. Predeterminado: en.
customTemplateIdUUIDOpcionalUUID de una plantilla personalizada guardada. La plantilla debe pertenecer al usuario de la clave API.
optionsobjectOpcionalOpciones de conversión: pageNumbers (boolean), bodyTextColor (hex), headingTextColor (hex), creativeAccent (slate|purple|blue|emerald|rose|amber).
Ejemplos de solicitudes
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)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
Diseño minimalista y moderno sin serifa con espaciado limpio.
Executive
Encabezados con serifa con acentos marino profesionales y números de página.
Resume
Diseño compacto de una columna optimizado para currículos.
Academic
Encabezados numerados, espaciado generoso y cuerpo EB Garamond.
Legal
Cuerpo serifa a doble espacio con formato de citas formal.
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.
| Estado | Significado | Acción |
|---|---|---|
| 200 | Éxito — PDF devuelto | Descargue el PDF del cuerpo de la respuesta. |
| 400 | Cuerpo de solicitud no válido | Verifique que su carga JSON coincida con el esquema anterior. |
| 401 | Clave API no válida o faltante | Verifique que su clave API esté activa y tenga el formato correcto. |
| 402 | Créditos API agotados | Compre más créditos desde su panel. |
| 404 | Plantilla personalizada no encontrada | Verifique que customTemplateId sea correcto y le pertenezca. |
| 415 | Content-Type incorrecto | Establezca el encabezado Content-Type a application/json. |
| 422 | Opciones de conversión no válidas | Verifique que su objeto options coincida con la especificación. |
| 429 | Límite de tasa alcanzado | Espere y vuelva a intentarlo. Verifique el encabezado Retry-After. |
| 500 | Error del servidor | Reintente 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.
$0
25 / month
Para pruebas y evaluación.
$9
500 / month
Para individuos y proyectos pequeños.
$29
1,000 / month
Generación prioritaria, soporte de plantillas personalizadas vía API.
¿Necesita más? Contáctenos para precios empresariales personalizados.