Cómo convertir documentos Markdown a PDF con Pandoc en GNU+Linux
Hay varias herramientas en línea para hacer esta tarea. Lamentablemente, son SaaS, por lo que no respetan nuestra libertad de ejercer el control sobre nuestra actividad informática. Por tanto, aquí presentaré el uso básico de Pandoc, una programa libre para convertir documentos de un formato a otro. En su página web oficial se listan los formatos soportados, pero aquí nos limitaremos a la conversión de un documento en formato Markdown a PDF.
Instalación
En distribuciones de basadas en Ubuntu (como Trisquel), basta con introducir en la terminal:
sudo apt install pandoc
En distribuciones basadas en Debian pero no en Ubuntu, puede que no funcione el sudo
. Por tanto, hay que cambiarse al usuario root primero:
su root
y luego:
apt install pandoc
Con eso Pandoc ya debería estar instalado.
Conversión: de Markdown a PDF
Lo primero que debemos hacer es abrir la terminal en la carpeta en la que se encuentra nuestro documento Markdown. Luego escribimos:
pandoc -f markdown -t latex -o ARCHIVO_DE_SALIDA.pdf ARCHIVO_DE_ENTRADA
Notar que ARCHIVO_DE_ENTRADA
es el nombre del archivo que queremos convertir mientras que ARCHIVO_DE_SALIDA
es el nombre que queremos para el archivo resultante.
El -f markdown
significa que queremos convertir desde Markdown, y el -t latex
significa que queremos convertir hacia un archivo LaTeX, que es la forma en la que Pandoc convierte hacia PDF. Es necesario poner .pdf
justo después del archivo de salida para que Pandoc convierta a PDF y no a otra cosa, en este caso el código en LaTeX del documento en el que estamos trabajando.