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.