Documentos · Pandoc
Word a Markdown
Tienes un .docx y lo necesitas en Markdown — para un blog, una wiki o un repositorio donde el texto plano se versiona y se busca mejor. Pandoc hace el camino inverso y, de paso, saca las imágenes incrustadas a una carpeta para que no se pierdan.
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 convierte el Word a Markdown estilo GitHub y extrae las imágenes que tuviera dentro:
pandoc documento.docx --extract-media=. -t gfm -o documento.md--extract-media=. guarda las imágenes en la carpeta actual y deja los enlaces ya apuntando a ellas; -t gfm produce GitHub Flavored Markdown, el dialecto que entienden GitHub, GitLab y la mayoría de los wikis.
Tareas relacionadas
Preguntas frecuentes
¿Qué significa la opción gfm?
GFM es GitHub Flavored Markdown, la variante con tablas, listas de tareas y bloques de código que usan GitHub y casi todas las plataformas modernas. Si tu destino es otro, Pandoc admite también -t markdown o -t commonmark.
¿Dónde quedan las imágenes del Word?
Con --extract-media=. Pandoc crea una subcarpeta dentro del directorio actual y vuelca ahí cada imagen, reescribiendo los enlaces del Markdown para que apunten a los archivos extraídos. Así el documento queda completo y portable.
¿Conserva el formato complejo, como columnas o cuadros de texto?
Markdown es un formato deliberadamente simple, así que los elementos de maquetación que no tienen equivalente (columnas, cuadros flotantes, encabezados de página) se simplifican o se omiten. El texto, los títulos, las listas y las tablas básicas sí pasan limpios.