Markdown a PDF: la guía completa

Markdown es muy apreciado por su sintaxis de texto plano mínima, mientras que PDF es el «producto final» multiplataforma de diseño fijo. Combinar ambos es una necesidad diaria para redactores, desarrolladores y equipos. Este artículo explica sistemáticamente las opciones y compromisos de Markdown a PDF.

Por qué convertir Markdown a PDF

• Escritura concentrada: Markdown te deja preocuparte solo por el contenido, no por el formato.
• Entrega estable: el PDF mantiene el diseño idéntico en cualquier dispositivo, ideal para contratos, currículums y documentos.
• Versionable: los archivos fuente son texto plano, perfectos para Git.

Tres enfoques principales

1. Impresión del navegador (la más precisa)

Renderiza Markdown a HTML y usa «Imprimir → Guardar como PDF» del navegador. Ventajas: estilo 100 % coherente, sin dependencias, gratis. Este es exactamente el principio del botón «Imprimir / Guardar como PDF» de esta herramienta.

2. Exportación con un clic mediante una librería de frontend (la más cómoda)

Usa html2pdf.js (que envuelve html2canvas + jsPDF) para convertir la página directamente en un archivo PDF. La ventaja es descargar con un clic, pero el CSS complejo (paginación, fondos) puede variar ligeramente.

3. Línea de comandos (la mejor para lotes)

Como pandoc, mdpdf, weasyprint. Ideales para generación por lotes en CI, pero requieren configurar el entorno.

Buenas prácticas de diseño

1. Usa @page { size: A4; margin: 16mm; } para controlar los márgenes de impresión.
2. Usa una fuente monoespaciada en los bloques de código y conserva los colores para legibilidad.
3. Usa reglas pagebreak en tablas largas para evitar cortes.
4. Evita anchos fijos en píxeles; deja que el PDF se adapte a la página.

Resumen

Para coherencia absoluta, usa la impresión del navegador; para descarga con un clic, usa una librería de frontend. Esta herramienta te ofrece ambas: escribe Markdown a la izquierda, previsualiza el diseño A4 en vivo a la derecha y exporta.

¿Quieres probarlo? Abre la herramienta de Markdown a PDF y pruébala ya.