5 formas de convertir Markdown a PDF comparadas (Pandoc, VSCode, online)
Para un documento puntual, /markdown-to-pdf requiere menos preparación. Pandoc destaca con citas y publicación; VS Code y la CLI encajan en edición o automatización. Decide por funciones, reproducibilidad y control local.
La comparación usa capacidades documentadas actuales, no cifras fijas de cronómetro o descarga, porque el tiempo de instalación y el tamaño del navegador dependen del sistema y la versión.
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.
Preparación y primera ejecución: Varía según sistema operativo, motor PDF, caché y complejidad; mídelo en tu entorno.
Pros: Sin instalación local y usable en navegador. Renderiza código, KaTeX, Mermaid, tablas, imágenes y tareas. La salida gratuita lleva marca; los usuarios gratuitos con sesión tienen actualmente cinco exportaciones sin marca en total.
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 # or mactex (platform-dependent)
pandoc input.md -o output.pdf
Preparación y primera ejecución: Varía según sistema operativo, motor PDF, caché y complejidad; mídelo en tu entorno.
Pros: probado, scriptable, plantillas LaTeX infinitas. Citas nativas (--bibliography). Offline. Tipografía calidad libro.
Contras: LaTeX pesa según plataforma. Salida por defecto es estética académica. Plantillas custom son difíciles. El resaltado necesita --syntax-highlighting 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).
Preparación y primera ejecución: Varía según sistema operativo, motor PDF, caché y complejidad; mídelo en tu entorno.
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".
Preparación y primera ejecución: Varía según sistema operativo, motor PDF, caché y complejidad; mídelo en tu entorno.
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
Preparación y primera ejecución: Varía según sistema operativo, motor PDF, caché y complejidad; mídelo en tu entorno.
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 | None | Browser request | yes | yes (KaTeX) | yes | One-offs |
| Pandoc | Pandoc + PDF engine | Setup-dependent | yes | yes | filter | Books, papers |
| VS Code Markdown PDF | Extension + renderer | Setup-dependent | yes | extension-dependent | no | Editor users |
| Browser print | None | Browser request | varies | source-dependent | source-dependent | Rendered pages |
md-to-pdf CLI | Node.js + browser runtime | Setup-dependent | yes | 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 --syntax-highlighting 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.
¿Cuál maneja mejor CJK / chino?
El renderizador alojado /markdown-to-pdf usa su entorno de fuentes del servidor. Las herramientas Chromium locales usan las fuentes de su runtime; Pandoc con XeLaTeX suele requerir una fuente CJK explícita como mainfont:. Prueba los caracteres reales.
¿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.
Los límites y comandos anteriores se comprobaron con estas fuentes primarias actuales:
Abre MarkdownToImage, renderiza Markdown y elige el formato adecuado. Antes de automatizar un lote, prueba un documento representativo.