Markdown es genial para escribir, pero quienes reciben tus documentos suelen esperar una página web o un PDF. La buena noticia: convertir Markdown es fácil y, en la mayoría de los casos, no necesitas una cadena de herramientas complicada.
A continuación tienes cuatro formas de hacerlo, de la más rápida a la más configurable, y una serie de consejos para que el resultado tenga un aspecto profesional.
Comparativa rápida
| Método | HTML | Instalación | Ideal para | |
|---|---|---|---|---|
| Exportar desde un editor en el navegador | ✅ | ✅ (imprimir) | Nada | Documentos del día a día, compartir rápido |
| VS Code + extensión | ✅ | ✅ | Editor + extensión | Quien ya escribe en VS Code |
| Pandoc | ✅ | ✅ | Pandoc (+ un motor PDF) | Libros, artículos, flujos automatizados |
| Un script (markdown-it, marked) | ✅ | — | Node.js | Webs a medida y procesos de compilación |
1. Exportar desde un editor en el navegador
La vía más rápida es un editor que exporte directamente. En Markdown Preview Editor abre o pega tu documento —en la versión online o en tu propia copia— y usa los botones de la cabecera:
- HTML crea un único archivo
.htmlindependiente. Los estilos, el resaltado de código, las fórmulas, los diagramas y las imágenes que abriste junto con el documento quedan incrustados, así que el archivo se ve bien en cualquier ordenador y puedes adjuntarlo a un correo o subirlo a cualquier sitio tal cual. - Imprimir abre el diálogo de impresión del navegador. Elige Guardar como PDF como destino para obtener un PDF. Solo se imprime el documento renderizado: ni barra de herramientas ni editor.
- Guardar descarga el código Markdown como archivo
.md.
Como todo ocurre en el navegador, también sirve para documentos que preferirías no subir a un conversor online.
Cómo obtener un PDF limpio desde el diálogo de impresión
- Ajusta los márgenes en Predeterminados o Mínimos, según cuánto texto quieras por página.
- Desactiva Encabezados y pies de página para quitar la fecha y la URL de los bordes de la página.
- Activa Gráficos de fondo si quieres conservar el fondo de los bloques de código y las filas alternas de las tablas.
- Usa un tema claro para imprimir: ahorra tinta y se lee mejor en papel.
2. VS Code con una extensión
VS Code tiene una vista previa de Markdown integrada, pero no un botón de exportar. Extensiones como Markdown PDF o Markdown Preview Enhanced añaden comandos para exportar a HTML y PDF. Es cómodo si VS Code ya es tu editor; el estilo del resultado depende de la extensión, y algunas descargan un navegador sin interfaz la primera vez que se usan.
3. Pandoc, el conversor universal
Pandoc convierte entre decenas de formatos y es la herramienta de referencia para libros, artículos académicos y documentación automatizada. Una vez instalado, la conversión es un solo comando:
bash# Markdown a una página HTML completa
pandoc report.md -o report.html --standalone --metadata title="Report"
# Markdown a PDF (necesita un motor PDF, p. ej. una distribución de LaTeX)
pandoc report.md -o report.pdf --pdf-engine=xelatex
# Markdown a Word, si alguien insiste
pandoc report.md -o report.docx
Sin --standalone, Pandoc genera solo un fragmento de HTML, algo útil si lo vas a insertar en una página existente. La salida en PDF requiere un motor aparte: una distribución de LaTeX o un motor basado en HTML como WeasyPrint. El punto fuerte de Pandoc es el control: plantillas, citas, secciones numeradas y referencias cruzadas.
4. Unas líneas de JavaScript
Si Markdown forma parte de tu propia web o de tu proceso de compilación, una biblioteca es la opción más flexible. Con markdown-it:
jsimport MarkdownIt from 'markdown-it';
import { readFileSync, writeFileSync } from 'node:fs';
const md = new MarkdownIt({ linkify: true, typographer: true });
const body = md.render(readFileSync('README.md', 'utf8'));
writeFileSync('README.html', `<!doctype html><meta charset="utf-8"><title>README</title>${body}`);
Los plugins añaden notas al pie, listas de tareas, fórmulas y más. Recuerda que el resultado es tan seguro como su entrada: si el Markdown viene de otras personas, sanea el HTML (por ejemplo, con DOMPurify) antes de publicarlo.
Consejos para un HTML y un PDF mejores
Empieza con un título claro
Los conversores toman el título del documento del nombre del archivo, del primer encabezado o de metadatos explícitos. Da a cada documento un nombre de archivo descriptivo y un único encabezado #, y el HTML y el PDF exportados serán fáciles de reconocer en la carpeta de descargas o en una pestaña del navegador.
Guarda las imágenes junto al documento
Usa rutas relativas como images/chart.png y mantén los archivos en la misma carpeta. Cuando abres la carpeta completa en Markdown Preview Editor, las imágenes se resuelven y se incrustan en el HTML exportado. Las imágenes remotas que no se cargan en la vista previa tampoco se incrustan.
Controla los saltos de página
Markdown no tiene sintaxis para saltos de página. En documentos impresos, empieza las secciones grandes con un encabezado ## y mantén las tablas cortas: los navegadores evitan partir las filas de una tabla, pero una tabla enorme seguirá continuando en la página siguiente. En herramientas que admiten HTML y estilos en línea, como Pandoc, puedes insertar <div style="page-break-after: always"></div>.
Revisa fórmulas y diagramas antes de exportar
En la mayoría de las herramientas, las fórmulas y los diagramas los renderizan bibliotecas de JavaScript. Revísalos primero en la vista previa; consulta nuestras guías sobre fórmulas matemáticas en Markdown y diagramas Mermaid. En la exportación a HTML de Markdown Preview Editor se guardan como marcado e imágenes ya generados, así que el archivo exportado no necesita ningún script.
Elige el tema a propósito
Un HTML exportado en tema oscuro resulta agradable en pantalla, pero es mala elección para el papel. Exporta pensando en el medio que usará el lector.
Preguntas frecuentes
¿Cómo convierto Markdown a PDF gratis?
Abre el documento en un visor de Markdown como Markdown Preview Editor, haz clic en Imprimir y elige Guardar como PDF en el diálogo de impresión. Para una salida automatizada o con formato de libro, usa la herramienta gratuita de línea de comandos Pandoc.
¿Cómo convierto Markdown a HTML sin instalar nada?
Usa un editor en el navegador con exportación a HTML. Markdown Preview Editor crea un archivo HTML independiente con los estilos incluidos, directamente en tu navegador.
¿Se incluyen las imágenes en el HTML exportado?
Las imágenes locales que abriste junto con el documento se incrustan en el archivo HTML, así que funciona por sí solo. Las imágenes que siguen en servidores remotos no se incrustan.
¿Puedo convertir Markdown a Word (DOCX)?
Sí, con Pandoc: pandoc input.md -o output.docx. Otra opción es exportar a HTML y abrirlo en Word, que conserva la mayor parte del formato.