5 formas de convertir Markdown a PDF comparadas (Pandoc, VSCode, online)
Compara cinco métodos Markdown a PDF con una muestra común y elige lotes web, exportación del editor, CLI local o Pandoc según la entrega.
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; admite resaltado, KaTeX, Mermaid, tablas, imágenes y tareas. Al iniciar sesión dispones de cinco exportaciones web sin marca en total y, después, de exportaciones ilimitadas con marca. Creator cuesta 9 USD al mes e incluye exportaciones web ilimitadas sin marca; el pase de 1 USD cubre una. Los créditos de API son independientes.
Alcance: La página PDF individual tiene un límite de entrada de 1 MB. La herramienta independiente de lotes de pago crea un ZIP con salidas separadas. Consulta los límites y las alternativas para combinar en la guía de lotes.
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
Pros: probado, scriptable, plantillas LaTeX infinitas. Citas nativas (--bibliography). Offline. Tipografía calidad libro.
Contras: Requiere motor PDF, fuentes y plantillas. Usa --syntax-highlighting para elegir el tema y verifica el resultado con tu motor. Prepara Mermaid como imágenes o configura un proceso de pretratamiento adecuado.
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).
Pros: Exportación desde el editor con CSS y resaltado configurables. El README actual documenta Mermaid y KaTeX; comprueba la versión instalada y su configuración.
Contras: La extensión necesita un navegador compatible; sus ajustes y CSS determinan el resultado. Una extensión de vista previa no necesariamente interviene en la exportación PDF. Prueba fórmulas, Mermaid, fuentes y saltos en el archivo.
Cuándo usarlo: Ya escribes y revisas en VS Code y quieres mantener los ajustes de exportación en ese flujo.
Bueno para: Markdown ya renderizado en navegador (README de GitHub, GitLab Wiki, sitio de docs).
Cómo: ⌘+P o Ctrl+P → "Guardar como PDF".
Pros: ya está allí. Sin instalación. Funciona en cualquier HTML renderizado.
Contras: La salida depende del CSS de impresión y de tus ajustes. Revisa fondos, colores, cabeceras, pies y saltos. Las fórmulas y los diagramas deben estar renderizados en la página.
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
Pros: scriptable. YAML front-matter para tematizar por documento. Modo watch. Offline una vez instalado.
Contras: Requiere Node.js y un entorno de navegador. La personalización usa configuración y CSS. Comprueba las extensiones Markdown necesarias; si un diagrama no se renderiza, prepáralo como imagen.
Cuándo: tu sitio de docs construye PDFs en CI; quieres PDFs en versionado junto al código.
Usa el nombre exacto de la documentación enlazada. md-to-pdf y markdown-pdf son paquetes distintos; revisa la versión y sus avisos antes de instalar.
| Método | Preparación local | Primera exportación | Resaltado | Fórmulas | Mermaid | Uso indicado |
|---|---|---|---|---|---|---|
/markdown-to-pdf | Sin instalación | Petición web | Compatible | KaTeX | Compatible | Documentos individuales |
| Pandoc | Motor PDF y fuentes | Según el entorno | Temas de sintaxis | Según el motor | Pretratamiento | Libros y citas |
| VS Code Markdown PDF | Extensión y renderizador | Según el entorno | Configurable | KaTeX | Compatible; configurar entorno | Flujo del editor |
| Impresión web | Página ya renderizada | Diálogo de impresión | Según la página | Según la página | Según la página | Páginas existentes |
md-to-pdf CLI | Node.js y navegador | Según el entorno | Configurable | Revisar configuración | Preparar imágenes | Compilaciones CI |
- 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.
Automatiza cuando debas reconstruir por calendario o commit. Para grupos ocasionales, los lotes web evitan la instalación local. Pandoc encaja en un documento ordenado con estructura editorial, citas y plantilla controlada.
¿Qué método preserva mejor el resaltado de código?
Los métodos Chromium pueden conservar el resaltado web con tema y ajustes de impresión coherentes. Pandoc usa sus propios temas. Compara la misma muestra en vez de asumir que los temas se trasladan sin cambios. Consulta la guía de resaltado.
¿Cuál hace conversión por lotes?
Para varios archivos, abre Exportación por lotes: es una herramienta de pago que admite hasta 15 Markdown por ejecución y descarga un ZIP con una salida por entrada. Creator incluye 20 ejecuciones al mes. PDF genera archivos separados; para un único documento combinado, usa Pandoc.
¿Por qué md-to-pdf y no markdown-pdf?
Esta guía usa md-to-pdf, enlazado arriba. Los nombres no son intercambiables; revisa documentación, versiones y avisos de cualquier alternativa.
¿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?
Compara el coste total: plan web, créditos de API si los usas, cómputo CI, fuentes y mantenimiento de plantillas. Creator para navegador no incluye créditos de renderizado API. Decide según el uso real.
Elige según la entrega: documento individual en web, ZIP de lotes web, compilaciones CI o un documento con bibliografía en Pandoc. Prueba la misma muestra y revisa los PDF reales.
# Document export test
## Handoff checklist
- [x] Headings
- [x] Table layout
- [x] Code formatting
| Check | Expected result |
|:--|:--|
| Body text | Readable at page width |
| Links | Retained in PDF |
> Demo content for comparing export methods.
Usa esta muestra en los métodos que estés valorando. La salida mostrada es un ejemplo del producto, no una prueba comparativa medida de las cinco herramientas. Comprueba bordes, tareas y selección de texto en cada PDF.
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.