Conversión de Markdown a otros formatos

Una de las grandes ventajas de Markdown es su portabilidad. Al ser texto plano, puede transformarse fácilmente a múltiples formatos sin perder estructura: HTML, PDF, DOCX, ODT, EPUB y presentaciones (por ejemplo con Reveal.js).

17.1 Pandoc: la herramienta universal

Pandoc es considerado el “cuchillo suizo” de la conversión de documentos. Fue creado por John MacFarlane y soporta decenas de formatos de entrada y salida.

Instalación

Linux (Debian/Ubuntu):

sudo apt install pandoc

macOS (Homebrew):

brew install pandoc

Windows: descargar desde el instalador oficial del sitio de Pandoc.

Uso básico

pandoc archivo.md -o salida.pdf
pandoc archivo.md -o salida.docx
pandoc archivo.md -o salida.html

👉 Pandoc interpreta Markdown y lo convierte al formato deseado automáticamente.

17.2 Conversión a HTML

Markdown fue pensado como alternativa simple a HTML, por lo que la conversión es directa.

pandoc articulo.md -o articulo.html

Se pueden aplicar plantillas y CSS personalizados para dar estilo.

17.3 Conversión a PDF

Para exportar a PDF, Pandoc suele apoyarse en un motor adicional como LaTeX, wkhtmltopdf o WeasyPrint.

pandoc informe.md -o informe.pdf

Personalizar tamaño de papel y fuente:

pandoc informe.md -o informe.pdf \
  --variable fontsize=12pt \
  --variable papersize=a4

17.4 Conversión a DOCX (Microsoft Word)

pandoc notas.md -o notas.docx

El archivo resultante conserva títulos, listas, enlaces e imágenes, listo para editar en Word.

17.5 Otras herramientas de conversión

Además de Pandoc, existen muchas herramientas y editores que exportan Markdown:

• Typora: exporta a PDF, DOCX, HTML, LaTeX.
• Obsidian: permite exportar notas a PDF.

Plugins y librerías

• markdown-pdf (Node.js): convierte .md a PDF por CLI.
• grip (Python): renderiza un .md como lo hace GitHub.
• md-to-pdf (Node.js): usa Puppeteer para exportar a PDF con estilos CSS.

17.6 Ejemplo práctico con Pandoc

Supongamos un archivo tutorial.md:

# Tutorial de Markdown

Markdown es un lenguaje ligero para crear documentos.

## Ventajas
- Fácil de escribir
- Legible en texto plano
- Exportable a múltiples formatos

Exportar a varios formatos:

# A PDF
pandoc tutorial.md -o tutorial.pdf

# A DOCX
pandoc tutorial.md -o tutorial.docx

# A HTML
pandoc tutorial.md -o tutorial.html

👉 Resultado: el mismo documento en tres formatos distintos sin modificar el original.

17.7 Buenas prácticas al exportar

• Usar encabezados bien jerarquizados (#, ##, ###) para que se mapeen a títulos en DOCX o PDF.
• Mantener imágenes con rutas relativas (img/archivo.png) para incluirlas correctamente.
• Probar la exportación en varios visores (el estilo puede variar según el motor).
• Para PDFs profesionales, integrar Pandoc con LaTeX para mejor control tipográfico.
• Para HTML, aplicar una hoja de estilo CSS personalizada.

Conclusión

Markdown es extremadamente flexible y puede transformarse en PDF, DOCX, HTML, EPUB y más. Pandoc es la herramienta más completa y potente para estas conversiones, y existen alternativas ligeras como Typora, Mark Text, Obsidian y varias librerías en Node.js o Python.