5 formas de convertir Markdown a PDF comparadas (Pandoc, VSCode, online)
Para la mayoría, /markdown-to-pdf en el navegador es la opción correcta — 5 segundos, sin instalación, especificación Markdown completa con resaltado, KaTeX y Mermaid. Pandoc es excesivo salvo que publiques un libro o un paper. Las otras tres existen por buenas razones, pero son más nicho de lo que parece online.
Probamos las cinco con un informe Markdown de 30 páginas (con código, KaTeX, tablas y Mermaid). Aquí va lo encontrado, por qué existe cada una y dónde gana realmente.
Bueno para: conversión puntual, resaltado de código, fórmulas, diagramas, sin instalación.
Cómo: abre /markdown-to-pdf, pega, clic en PDF.
Tiempo al primer PDF: ~5 segundos.
Pros: cero instalación, funciona en cualquier navegador. Markdown completo con KaTeX y Mermaid. Temas claro/oscuro. Sin marca de agua para cuentas gratuitas.
Contras: límite 1 MB. Un archivo por vez — para lotes ver Convertir varios Markdown a PDF en lote.
Cuándo: el 95 % de las conversiones puntuales.
Bueno para: artículos académicos, plantillas LaTeX propias, citas y referencias, salida multi-formato (PDF + DOCX + EPUB de una sola fuente).
Cómo:
brew install pandoc
brew install --cask basictex # o mactex (~5 GB)
pandoc input.md -o output.pdf
Tiempo al primer PDF: 30–90 minutos la primera vez (instalar Pandoc + LaTeX, pelear con plantillas). Luego 5 segundos.
Pros: probado, scriptable, plantillas LaTeX infinitas. Citas nativas (--bibliography). Offline. Tipografía calidad libro.
Contras: LaTeX pesa 3–5 GB. Salida por defecto es estética académica. Plantillas custom son difíciles. El resaltado necesita --highlight-style y luce desactualizado por estándares web. Mermaid requiere un filter plugin.
Cuándo: publicas un libro, tesis, paper con bibliografía, o mantienes 3+ plantillas PDF que quieres versionadas.
Bueno para: quien escribe Markdown en VSCode todo el día.
Cómo: instala el plugin "Markdown PDF" de yzane, clic derecho → Markdown PDF: Export (pdf).
Tiempo al primer PDF: 10 segundos la primera vez (descarga Chromium en silencio, ~150 MB).
Pros: un clic desde donde ya estás escribiendo. CSS configurable vía settings. Estilo por defecto decente.
Contras: primer export lento por la descarga de Chromium. La estética se cambia solo por CSS. KaTeX no funciona out of the box — necesitas un plugin Markdown+Math aparte. Mermaid se queda como código, no como diagrama.
Cuándo: escribes 5+ PDFs por semana y tu editor es VSCode.
Bueno para: Markdown ya renderizado en navegador (README de GitHub, GitLab Wiki, sitio de docs).
Cómo: ⌘+P o Ctrl+P → "Guardar como PDF".
Tiempo al primer PDF: 3 segundos.
Pros: ya está allí. Sin instalación. Funciona en cualquier HTML renderizado.
Contras: los cortes de página parten tablas y bloques de código de forma impredecible. El resaltado pierde color en Firefox al imprimir. Encabezados/pies por defecto incluyen URL y página, hay que desactivarlos manualmente. No renderiza KaTeX o Mermaid si la página origen no lo hace.
Cuándo: necesitas un PDF ahora de una página Markdown ya renderizada y los detalles ásperos no importan.
Bueno para: pipelines de build, CI/CD, docs automatizadas.
Cómo:
npm install -g md-to-pdf
md-to-pdf input.md
Tiempo al primer PDF: 10 segundos (incluye Chromium de Puppeteer, ~120 MB la primera vez).
Pros: scriptable. YAML front-matter para tematizar por documento. Modo watch. Offline una vez instalado.
Contras: dependencia de Node + Chromium. Tematización solo YAML + CSS, menos expresiva que Pandoc/LaTeX. Mermaid no out of the box — necesita plugin markdown-it.
Cuándo: tu sitio de docs construye PDFs en CI; quieres PDFs en versionado junto al código.
Nota: evita el viejo paquete markdown-pdf (sin guion) — sin actualizar desde 2019, con avisos de seguridad conocidos. md-to-pdf es el sucesor mantenido.
| Método | Instalación | Primer PDF | Resaltado | Mate | Mermaid | Bueno para |
|---|---|---|---|---|---|---|
/markdown-to-pdf | 0 MB | 5 s | sí | sí (KaTeX) | sí | Puntual |
| Pandoc | 3–5 GB | 30–90 min | básico | sí (LaTeX) | filter | Libros, papers |
| Plugin VSCode | 150 MB | 10 s | sí | con plugin | no | Usuarios VSCode |
| Imprimir navegador | 0 MB | 3 s | varía | no | no | Ya renderizado |
md-to-pdf CLI | 120 MB | 10 s | sí | configurable | plugin | CI/CD |
- La mayoría →
/markdown-to-pdf. Es la respuesta para ~95 % de los casos. - Académicos con citas → Pandoc.
- Usuarios VSCode diarios → el plugin VSCode.
- DocOps / CI →
md-to-pdfCLI. - README de GitHub ya → imprimir desde navegador, asumir las asperezas.
La tentación con herramientas Markdown → PDF es la sobreingeniería. Para un documento, no instales nada. Para mil, automatiza con CLI. Rara vez hay un punto medio que justifique Pandoc para un caso no académico.
¿Qué método preserva mejor el resaltado de código?
Los basados en Chromium headless (/markdown-to-pdf, plugin VSCode, md-to-pdf CLI). Renderizan a través de Chromium real, así cualquier tema highlight.js/Prism se mantiene. El --highlight-style de Pandoc luce viejo según estándares web. Más en Markdown a PDF con resaltado de código.
¿Cuál hace conversión por lotes?
La CLI nativamente (md-to-pdf chapter*.md). Para la web, ver Convertir Markdown a PDF en lote.
¿Por qué md-to-pdf y no markdown-pdf?
markdown-pdf (sin guion) sin actualizar desde 2019, con avisos de seguridad. md-to-pdf es el sucesor mantenido.
¿Hay API de Markdown a PDF?
Sí — ver nuestra Markdown to Image API, con salida PDF para uso programático.
¿Cuál maneja mejor CJK / chino?
/markdown-to-pdf y md-to-pdf usan la pila de fuentes del navegador anfitrión, así CJK funciona si el sistema tiene una. Pandoc con XeLaTeX necesita mainfont: explícito. El plugin VSCode maneja CJK out of the box.
¿Cuál sale más barato a escala?
Para 100+ PDFs/semana, md-to-pdf en CI es prácticamente gratis (solo cómputo). Para uso ocasional, la vía web cuesta cero. Pandoc es gratis pero el mantenimiento de plantillas es coste oculto.
La elección depende del volumen. Un PDF → herramienta web. Mil PDFs → CLI en CI. Libros con citas → Pandoc. No saques el martillo pesado hasta haber sentido el dolor del ligero.