Markdown permite a desarrolladores, escritores y aplicaciones de notas mantener el texto legible como texto plano y, a la vez, marcar títulos, listas y énfasis. Sin embargo, la mayoría de los lectores no pueden abrirlo con formato. Markdown a PDF convierte el archivo con Pandoc y lo presenta como un documento con estilo, para que un README, un archivo de actas o una documentación se conviertan en un PDF que cualquiera puede leer.
Cómo usar Markdown a PDF
- Añade el archivo .md o .markdown.
- Pulsa Convertir a PDF.
- Descarga el PDF.
- Revisa las tablas, los bloques de código y los enlaces del resultado.
Qué recibe formato
Pandoc entiende la sintaxis habitual de Markdown: títulos, párrafos, negrita y cursiva, listas ordenadas y sin ordenar, citas, enlaces, líneas horizontales, bloques de código delimitados y tablas con barras verticales. Los convierte a HTML, que después se maqueta en páginas PDF, y los enlaces siguen siendo clicables en el PDF. La notación matemática escrita en TeX no se compone como ecuaciones, así que los documentos que dependen mucho de las matemáticas necesitan una herramienta de composición específica.
Imágenes y servidores sin Pandoc
La herramienta convierte un único archivo Markdown, así que las imágenes referenciadas con rutas relativas no están disponibles, y las imágenes de direcciones web se bloquean por seguridad. Si necesitas los diagramas, conviértelos por separado con Imágenes a PDF. El formato depende de que Pandoc esté instalado en el servidor; si no lo está, VelloDoc genera igualmente un PDF, pero muestra el Markdown como texto plano con sus símbolos visibles.
Flujos de documentación
Markdown a PDF es ideal para compartir documentación con personas ajenas a un repositorio de código, como clientes, auditores o responsables. Reúne varios archivos convertidos en un manual con Unir PDF y numera las páginas con Numerar páginas. Para notas sencillas sin estructura, basta con TXT a PDF, y PDF a Markdown vuelve a extraer el texto. La guía de formatos explica las ventajas e inconvenientes.
Cuándo se usa Markdown a PDF
Archivos README para quien no programa
Da a clientes o responsables un PDF legible del README de un proyecto sin pedirles que naveguen por un repositorio.
Actas de reuniones y diarios
Convierte notas guardadas en aplicaciones de Markdown en documentos que puedes archivar, imprimir o enviar como actas.
Documentación técnica
Empaqueta guías de instalación y procedimientos operativos como PDF para auditorías, traspasos o consulta sin conexión.
Limitaciones que conviene conocer
Markdown a PDF convierte un archivo cada vez, así que las imágenes relativas no se incluyen y las remotas se bloquean. Las fórmulas en TeX no se componen. El formato completo requiere Pandoc en el servidor; sin él, el resultado es texto plano. También se necesita WeasyPrint.
Markdown a PDF: preguntas frecuentes
¿Qué sintaxis de Markdown se admite?
Títulos, énfasis, listas, citas, enlaces, bloques de código delimitados, líneas horizontales y tablas con barras verticales, todo ello mediante Pandoc.
¿Por qué faltan mis imágenes?
Solo se sube el archivo Markdown, así que las imágenes referenciadas con rutas relativas no se encuentran, y las imágenes remotas se bloquean. Convierte las imágenes por separado y une los PDF si hace falta.
¿Por qué mi PDF muestra los símbolos de Markdown en bruto?
El servidor no tiene Pandoc instalado, así que el archivo se generó como texto plano. Un servidor con Pandoc produce un resultado con formato.
¿El código tiene resaltado de sintaxis?
Los bloques de código mantienen su diseño monoespaciado y sus saltos de línea. El resaltado en color depende de la versión de Pandoc del servidor, así que no confíes en él para entender el código.