Documentos · Pandoc
Markdown a HTML
De un archivo Markdown a una página web autocontenida que puedes subir a cualquier servidor o abrir en el navegador. Pandoc genera el HTML completo, le aplica tu hoja de estilos y le pone el título correcto en la pestaña del navegador.
1. Instala Pandoc
Se instala una sola vez y queda para siempre. Es gratis y de código abierto:
# macOS (Homebrew)
brew install pandoc
# Ubuntu / Debian
sudo apt install pandoc
# Windows (winget)
winget install JohnMacFarlane.PandocSi nunca has usado la terminal, empieza por la guía de la terminal.
2. El comando exacto
Este comando produce una página entera, con su estructura <html> completa, enlazada a tu CSS:
pandoc documento.md -s --css=estilo.css --metadata title="Mi documento" -o pagina.htmlLa bandera -s (de standalone) es la clave: sin ella Pandoc solo escupe el fragmento de cuerpo; con ella entrega un documento HTML válido y listo para publicar. --metadata title rellena la etiqueta de título, que de otro modo quedaría vacía.
Tareas relacionadas
Preguntas frecuentes
¿Por qué necesito la bandera -s?
Sin -s, Pandoc devuelve solo el HTML del contenido, sin <head> ni etiquetas de apertura, pensado para insertarlo dentro de otra plantilla. Con -s obtienes una página completa y válida que el navegador abre por sí sola.
¿Puedo incrustar el CSS dentro del archivo en vez de enlazarlo?
Sí. Si quieres un único archivo que viaje sin depender de estilo.css, añade --embed-resources --standalone y Pandoc incrustará la hoja de estilos y las imágenes dentro del propio HTML.
¿Sirve para varios archivos a la vez?
Puedes pasar varios .md en un mismo comando y Pandoc los unirá en una sola página. Para convertir cada archivo a su propia página, usa un bucle como el de la tarea Convertir una carpeta de documentos.