Un editor de textos. Cualquiera sirve: Geany, Gedit, Notepad++… O si te animas a una herramienta de línea de comandos: Nano, Vim, GNU Emacs… Sólo revisa que esté configurado para trabajar con codificación UTF-8 (no BOM). O si prefieres usar un programa que te permita ver el resultado mientras editas, revisa Obsidian, Ghostwriter, Writemonkey o Zettlr.
Pandoc. Instalar Pandoc. En GNU/Linux, basta con instalarlo desde tu repositorio oficial.
LaTeX. Installar
texlive-full. En GNU/Linux, basta con instalar
texlive-full desde tu repositorio. Ojo: son alrededor de 8
GB. Puedes instalar una versión más básica y dejar para más adelante
otros paquetes, conforme los vayas necesitando. En la página de LaTeX
encontrarás más información.
Tipografías de Office (si usas GNU/Linux y las
necesitas). Instala, desde tu repositorio,
ttf-mscorefonts-installer.
El comando más simple de Pandoc para convertir un texto a html (pdf, odt, docx, tex o lo que quieras) es:
pandoc entrada.md -o salida.html
Puedes mejorar esa salida añadiendo la opción -s
(--standalone)
pandoc entrada.md -s -o salida.html
Y mucho mejor, si tienes un bloque yaml que contenga toda la metadata
que necesite tu archivo de salida (título, lenguaje, autores, palabras
clave, resumen…). Inclui un pequeño bloque así, a modo de ejemplo, en el
mismo directorio de este archivo que lees descárgalo. El archivo se
llama: metadata.yaml.
pandoc entrada.md metadata.yaml -s -o salida.html
Puedes unir varios archivos:
pandoc entrada1.md entrada2.md entrada3.md metadata.yaml -s -o salida.pdf
¿Quieres añadir una tabla de contenidos? Sin problema:
pandoc entrada1.md entrada2.md entrada3.md metadata.yaml -s --toc=true -o salida.html
Es mucho lo que puedes hacer con Pandoc. Por eso te recomiendo encarecidamente leer su manual.
Volver a la Guía rápida de Markdown o a la página principal