Cómo convertir Markdown a PDF (gratis, con código y tablas intactos)

Markdown es donde se escriben las cosas — README, notas de reunión, especificaciones, documentación. PDF es donde las cosas se envían: a un cliente que no abrirá un .md, a un jefe que quiere un adjunto, a una impresora. El hueco entre ambos es una conversión, y no deberías necesitar instalar pandoc y una distribución LaTeX para cruzarlo.

La pega de la mayoría de rutas rápidas es que destrozan exactamente las partes de las que dependen los documentos técnicos: los bloques de código colapsan en tipografía proporcional, las tablas de barras se imprimen como un muro de caracteres | y las listas anidadas se aplastan. Un conversor solo es útil aquí si el código y las tablas sobreviven — así que ese es el listón que esta guía exige a todo.

Cómo convertir — paso a paso

🔒 pdfty.com/en/tools/markdown-to-pdf

Qué se renderiza, exactamente

El conversor soporta Markdown estándar más las extensiones que importan para la escritura técnica:

• Títulos — jerarquía de tamaños, con líneas sutiles bajo H1 y H2
• Bloques de código con vallas — monoespaciado, fondo gris claro, sangría preservada, resaltado de sintaxis para los lenguajes comunes
• Código en línea — el familiar estilo de chip gris
• Tablas — las tablas de barras estilo GitHub se vuelven tablas con bordes y fila de cabecera sombreada
• Citas — borde izquierdo, texto atenuado
• Listas — ordenadas, desordenadas, anidadas
• Enlaces — se conservan como enlaces clicables en el PDF
• Imágenes por URL — las imágenes ![](https://…) se descargan y se incrustan

La página se tipografía a un ancho de lectura cómodo con márgenes generosos — más cerca de «documento interno que se ve terminado» que de una impresión cruda del navegador.

Qué NO se renderiza

Sección de honestidad. Markdown tiene dialectos, y esta herramienta implementa Markdown estándar + tablas + código con vallas, no el sabor GitHub completo:

• Las listas de tareas (- [ ] pendiente) se imprimen como corchetes literales, no como casillas.
• El tachado (~~texto~~) no se convierte — las tildes se quedan.
• Las imágenes locales (![](./diagrams/arch.png)) no pueden aparecer: subes un solo archivo y el servidor no tiene acceso a los archivos que están a su lado en tu disco. Aloja la imagen en una URL o cuenta con un hueco.
• Los bloques Mermaid / de matemáticas se renderizan como bloques de código planos, no como diagramas ni ecuaciones.
• Sin temas personalizados — una hoja de estilos integrada, sin subida de CSS.

Alternativas locales gratuitas

pandoc — el conversor canónico: pandoc README.md -o readme.pdf. Salida soberbia e infinitamente configurable, pero la salida PDF requiere un motor LaTeX (a menudo una instalación de 1–4 GB). Vale la pena si conviertes documentos cada semana; absurdo para un README.

Extensiones de VS Code (p. ej. «Markdown PDF») — cómodas si ya vives en VS Code; la calidad de salida varía según la extensión y el tema.

Vista previa del navegador + imprimir: renderiza el Markdown donde sea que se previsualice (muchos editores sirven una vista HTML), luego Ctrl/Cmd+P → Guardar como PDF. Gratis y local, pero heredas las manías de impresión del navegador: cabeceras/pies con URL salvo que los desactives y saltos de página cayendo en mitad de un bloque de código.

macOS: sin renderizador de Markdown integrado — Vista Previa y TextEdit tratan .md como texto plano, así que verías las almohadillas y asteriscos en crudo.

Detalles prácticos a tener en cuenta

• Los saltos de página son automáticos. Los bloques de código largos pueden partirse entre páginas. No hay marcador manual de salto de página; el motor corta donde hace falta.
• Las tablas muy anchas y las líneas de código largas se escalan o se recortan al ancho del contenido — una fila de tabla de 200 caracteres no cabe con gracia en una página vertical. Acorta líneas donde puedas.
• El front matter (--- YAML al inicio del archivo) se trata como contenido, no se oculta — bórralo antes de convertir si no quieres que se imprima. (Un bloque --- justo al principio puede renderizarse también como línea horizontal más texto, según el formato.)
• Los códigos cortos de emoji como :rocket: quedan literales; los emoji reales pegados generalmente se renderizan.
• Revisa los destinos de los enlaces. Los enlaces relativos ([docs](./docs/setup.md)) sobreviven como enlaces pero no apuntan a nada útil una vez impresos.

Una vez que el PDF existe, aplica la caja de herramientas habitual: estámpalo con Encabezado y pie para contadores de página, combina capítulos con Unir, o encoge uno cargado de imágenes con Comprimir.

Preguntas frecuentes

¿Los bloques de código conservan el resaltado de sintaxis?

Sí — los bloques con valla y pista de lenguaje (```python) reciben resaltado en color; sin pista, quedan en monoespaciado plano sobre gris. En ambos casos la sangría se preserva exactamente.

¿Las tablas se renderizan de verdad como tablas?

Sí — las tablas de barras (el estilo GitHub) se vuelven tablas con bordes y fila de cabecera sombreada. El parser respeta los dos puntos de alineación.

¿Por qué falta mi imagen en el PDF?

Está referenciada por una ruta local. La subida es un único archivo .md, así que ./images/x.png no apunta a nada. Usa una URL https:// completa, o convierte en local con pandoc, donde las rutas relativas sí resuelven.

¿Puedo convertir un README directamente desde GitHub?

Descarga primero el .md en crudo y luego súbelo. Las insignias e imágenes alojadas en URL completas suelen pasar; las funciones exclusivas de GitHub (listas de tareas, mermaid) no — mira la lista de arriba.

¿Puedo cambiar fuentes, márgenes o colores?

No en esta herramienta — trae una única hoja de estilos deliberadamente limpia. Para un diseño de marca, pasa por HTML a PDF con tu propio CSS.

¿Hay límite de tamaño o de páginas?

Gratis: 20 MB por archivo y 10 operaciones al día — para archivos de texto eso es efectivamente sin límite. Los PDF de salida de más de 50 páginas se generan bien desde una única fuente Markdown.

¿Mi documento es privado?

La transferencia va por HTTPS y los archivos se eliminan automáticamente en menos de 1 hora. Para material confidencial que no puedas subir, pandoc es la vía local.

¿Puedo ir en la otra dirección — PDF a Markdown?

Directamente no. Lo más cercano es Extraer texto (texto plano, sin formato) o PDF a Word y limpiar desde ahí.