Cómo convertir Markdown a PDF sin perder el formato (2026)
Has escrito un documento Markdown impecable. Pulsas «exportar a PDF» y, de repente, los bloques de código se parten mal, las tablas se salen de la página y un párrafo queda cortado por la mitad.
Esta guía explica cómo convertir Markdown a PDF sin perder el formato, incluidos el código, las tablas, las imágenes, los enlaces y los saltos de página, con un conversor online gratuito, VS Code y Pandoc.
Por qué Markdown → PDF estropea el diseño
Markdown es texto plano; el PDF es una página fija. Casi todos los fallos vienen de cuatro puntos:
| Problema | En el PDF | Causa |
|---|---|---|
| Bloques de código cortados | Líneas que desaparecen en el borde | Falta control de saltos de página |
| Tablas recortadas | Faltan columnas a la derecha | Ancho de página insuficiente |
| Cambia la tipografía | Aparecen serifas y tamaños raros | Falta de mapeo de fuentes |
| Última página en blanco | Una página final vacía | Saltos o márgenes sobrantes |
Si lo corriges, el PDF se parecerá a la vista previa.
Método 1: conversor online gratuito (el más rápido)
La mejor opción si quieres exportar con un clic y sin instalar nada:
- Abre el conversor Markdown → PDF
- Pega tu Markdown (o sube un archivo
.md) - Elige una plantilla (Classic, Modern, Academic…)
- Pulsa Descargar PDF
Lo que se mantiene:
- Títulos y espaciados
- Negrita, cursiva y
código en línea - Bloques de código con resaltado de sintaxis
- Tablas, listas y citas
- Imágenes y enlaces
Consejo: elige la plantilla antes de exportar. Las plantillas académicas tienen márgenes más ajustados y una jerarquía de títulos pensada para imprimir.
Método 2: VS Code (el mejor para documentación en un repositorio)
- Instala Markdown PDF
- Abre el archivo
.md Cmd/Ctrl+Shift+P→ Markdown PDF: Export (pdf)- Guárdalo junto al archivo original
La vista previa se corresponde bastante con GitHub Flavored Markdown.
Método 3: Pandoc (el mejor para lotes y CI)
pandoc README.md -o README.pdf --pdf-engine=xelatex
Opciones útiles:
pandoc doc.md -o doc.pdf --wrap=pre --highlight-style=tango
pandoc doc.md -o doc.pdf -V geometry:margin=1in -V papersize:a4
Pandoc necesita un motor LaTeX. Para exportaciones puntuales, el conversor online es más cómodo.
Los 6 detalles que debes conservar
1. Bloques de código
```python
def hello():
print("Hello, PDF!")
```
- Indica siempre la etiqueta de lenguaje
- Ajusta las líneas muy largas cuando puedas
- No dejes que se recorten
2. Tablas
Cabeceras cortas. Las tablas anchas son la causa más frecuente de columnas recortadas:
| Formato | Ideal para | ¿Editable? |
|----------|-------------------|------------|
| Markdown | Escribir | Sí |
| PDF | Compartir/imprimir| No |
| DOCX | Revisar | Sí |
3. Saltos de página
<div style="page-break-after: always;"></div>
Insértalo antes de los capítulos importantes.
4. Imágenes
- Rutas relativas (
./images/chart.png) o HTTPS - PNG/JPEG de menos de 1–2 MB
- Con texto alternativo
5. Enlaces
[Guía de sintaxis de Markdown](/blog/markdown-syntax-guide)
6. Jerarquía de títulos
Un # para el título y luego ## / ###.
Lista de comprobación antes de exportar
- Un solo título
# - Bloques de código con vallas y lenguaje
- Tablas que quepan en una página vertical
- Imágenes visibles en la vista previa
- Sin restos de HTML suelto en el texto
Preguntas frecuentes
¿Cómo convierto Markdown a PDF gratis?
Pégalo en un conversor online de Markdown a PDF y descarga el archivo. Sin registro y sin marcas de agua: todo ocurre en el navegador.
¿Por qué se cortan los bloques de código en el PDF?
Por líneas largas y por falta de control de saltos de página. Usa vallas, ajusta las líneas y elige una herramienta que no parta los bloques por la mitad.
¿Se mantiene el resaltado de sintaxis en el PDF?
Sí, con conversores que primero renderizan HTML con resaltado y luego lo maquetas como PDF. Nuestro conversor Markdown → PDF lo hace.
¿PDF o Word?
PDF para la entrega final y la impresión. Word si alguien todavía tiene que editar el documento. Comparativa en Markdown vs HTML vs LaTeX.
Siguientes pasos
- Prueba a exportar: Markdown → PDF
- Sigue editando: Markdown → Word
- Sintaxis: Guía de sintaxis de Markdown
- Para consultar: Chuleta de Markdown