Markdown a PDF

Por qué Markdown todavía necesita una salida a PDF

Markdown ganó terreno porque es rápido de escribir y se compara limpio en git, pero casi nadie fuera de ingeniería quiere leerlo en crudo. Notas de versión, exportaciones de README, wikis internas, informes generados por IA, artículos de base de conocimiento — todo eso termina necesitando llegar a una bandeja de entrada o a una carpeta de cumplimiento como un documento con márgenes, numeración de página y una maquetación estable. Este endpoint es esa salida: el mismo Markdown que su equipo ya escribe se convierte en un PDF que un cliente, el área de finanzas o un auditor puede abrir sin preguntar qué es un archivo .md.

Qué le pasa realmente a su archivo

El servicio analiza el Markdown y construye un árbol de documento estructurado, y luego lo maqueta con reglas tipográficas que la función de imprimir de un navegador ignora: interlineado razonable, control de líneas viudas y huérfanas, saltos de página que respetan los títulos, y tablas que no quedan cortadas a la mitad en el borde de una página. Los bloques de código mantienen el formato monoespaciado sin desbordar el margen; las listas anidadas conservan su sangría. El resultado es un único PDF autocontenido, no una carpeta de archivos sueltos.

Qué envía y qué recibe

Envía el Markdown de origen (o un enlace a él) por POST a /pdf/from-markdown. Como el renderizado y la paginación toman tiempo real de cómputo en documentos largos, la llamada es asíncrona: recibe un task_id de inmediato y el PDF terminado llega a su webhook firmado, o lo consulta mediante un enlace firmado válido por 24 horas. Nada se queda esperando sobre una conexión HTTP abierta.

Dónde encaja en un flujo automatizado

Al ser una sola llamada REST, se integra en lo que sea que genere el Markdown en primer lugar: un job de integración continua que arma notas de versión en cada etiqueta, un CMS que exporta artículos como PDF de marca, o una herramienta interna que convierte el registro Markdown de un ticket de soporte en un adjunto formal. Nunca toca una librería de renderizado, un archivo de fuentes ni un navegador sin interfaz.

Un cobro que corresponde al trabajo

El precio es una tarifa base pequeña por solicitud más un cargo por página, publicado y predecible, así un changelog de una página y un manual de cuarenta cuestan cantidades proporcionalmente distintas — nunca una estimación plana. Una tarea que falla tras tres reintentos nunca se cobra, y los resultados se eliminan al vencer el período de retención sin usarse jamás para entrenar nada.