Lo que he aprendido: Emacs como editor de Markdown

Como lo prometido es deuda hoy traigo el procedimiento para poder usar Emacs como editor de Markdown.

Lo primero que tenemos que hacer es instalar el modo Markdown, para esto tenemos dos opciones:

  1. Descargarnos el archivo markdown-mode.el de aquí y cargarlo con M-x load-file. Esto tendríamos que hacerlo cada vez que queramos usar el modo Markdown o si no cambiar el archivo de configuración de Emacs1.

  2. Descargar directamente el paquete que lo contiene. En la misma página pone cuál es el paquete dependiendo de vuestro sistema operativo o distro.

Yo he utilizado el primer método en Windows y el segundo en Linux Mint, es decir, como es una distro basada en Ubuntu he hecho:

$ sudo apt-get install emacs-goodies-el

Ahora si pasamos al modo Markdown con M-x markdown-mode2 y escribimos cosillas veremos colorines como estos:

markdown

Si queremos ver como queda esto necesitamos algo que nos transforme el archivo .md a otra cosa. Aquí de nuevo tenemos varias opciones, os pongo dos:

  • Instalamos el paquete markdown, que nos convierte a html. Si hacemos C-c C-c p se abrirá el navegador y nos enseñará como queda nuestro archivo una vez traducido. Una cosa que hay que tener en cuenta es que si queremos poner tildes tendremos que escribir esto en la primera línea3:
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
  • Instalamos pandoc, que es una máquina de convertir tipos de archivos y le decimos a Emacs que lo use4

Yo he hecho una fusión entre la primera opción y la segunda: veo como queda en el navegador pero luego paso el archivo md a pdf con pandoc5:

$ pandoc input.md --latex-engine=xelatex -o output.pdf

Algunas veces me ha dado problemas si el pdf de salida no existe, pero es tan fácil de solucionar como crear un archivo vacío:

$ touch output.pdf

La traducción de archivo Markdown a pdf se hace exactamente igual en Windows.

En esta conversión también hay que tener cuidado con la codificación: tiene que estar en UTF-8 para que ponga las tildes bien. En Windows esto puede hacerse muy fácil abriendo el Bloc de Notas y cambiando la codificación en Guardar como… en la parte de abajo. En Linux Mint me guarda en UTF-8 por defecto así que no he tenido problemas.

Después de todo este lío ya podemos generar nuestro simpático documento pdf, que para el ejemplo anterior queda:

pdf

Ha sido mucho currelo pero ha merecido la pena 😀

Bonus

Por si os quedáis con ganas de saber más sobre la codificación Tom Scott os lo explica:


  1. Eso es algo que todavía no me he puesto a aprender, pero aquí podéis leer un poco más sobre ello. 
  2. también hay un modo gfm-mode (GitHub Flavoured Markdown) que es un poco diferente. 
  3. Más info aquí 
  4. Como en el caso anterior, no me da la vida para hurgar tanto, pero podéis haceros una idea de como va el tema aquí 
  5. Esto está directamente cogido de la documentación de pandoc. En algunos sitios, como este, veréis que usan markdown2pdf README.md -o readme-pandoc.pdf, pero parece ser que esto es algo antiguo y que ahora se usa el compilador de Latex. El motivo de usar xelatex tiene relación con la codificación pero no lo tengo claro. 
Anuncios

5 pensamientos en “Lo que he aprendido: Emacs como editor de Markdown

  1. ekaitzzarraga

    He estado haciendo pruebas locas con esto y Libreoffice writer abre los documentos HTML con mucho amor.
    Si pasas el archivo en markdown a HTML queda todo perfect con el Libreoffice.

    Responder
  2. Pingback: Lo que he aprendido: más Markdown, Emacs y UTF-8 | Onda Hostil

  3. Pingback: Lo que he aprendido: Markdown + pandoc para la ciencia | Onda Hostil

  4. Pingback: Compilación: escribir en Emacs | Onda Hostil

¡Opina sin miedo! (Puedes usar Markdown)

Introduce tus datos o haz clic en un icono para iniciar sesión:

Logo de WordPress.com

Estás comentando usando tu cuenta de WordPress.com. Cerrar sesión / Cambiar )

Imagen de Twitter

Estás comentando usando tu cuenta de Twitter. Cerrar sesión / Cambiar )

Foto de Facebook

Estás comentando usando tu cuenta de Facebook. Cerrar sesión / Cambiar )

Google+ photo

Estás comentando usando tu cuenta de Google+. Cerrar sesión / Cambiar )

Conectando a %s