A veces necesitamos escribir rápidamente un documento, con un mínimo de formato. Eso implica abrir algo más que el editor del sistema (bloc de notas, kedit, etc…). Terminamos abriendo un documento Word, OpenOffice, una plantilla LaTeX los más acostumbrados… Y no acaba de ser práctico. Acabo de descubrir un servicio muy simpático para generar documentos rápidamente en formatos múltiples a partir de un único documento fuente. Para ello utilizamos tres herramientas: Dillinger, Dropbox y Pandoc.
Flujo de trabajo
- Entramos en la aplicación online Dillinger. Esta web muestra un editor a la izquierda y un previo del aspecto del documento a la derecha. En Dillinger podremos escribir en el formato Markdown.
- Importamos y/o grabamos nuestro trabajo en Dropbox. Si autorizamos en nuestra cuenta de Dropbox a Dillinger, nos creará una carpeta con su nombre en la que guardará nuestros archivos Markdown con el nombre que hayamos puesto de título.
- Usamos pandoc para interpretar el archivo Markdown. De esta manera podemos generar archivos .html, .docx, .pdf, … Esto se hace por línea de comandos pero es tremendamente sencillo. Basta con ir a la carpeta Dropbox/Dillinger y escribir algo como:
1 |
pandoc -o resultado.pdf archivo_markdown.md |
Preparación del entorno
Necesitamos instalar Dropbox y pandoc en la máquina que vayamos a usar. Hay instaladores o paquetes para Windows, Mac OS y Linux. Dillinger no necesita instalación, y basta con entrar en la web.
Ventajas
- No necesitas copiar y pegar el mismo texto en diferentes formatos. Con un sólo archivo .md tienes el mismo contenido para todo.
- Centralizar los cambios. Por ejemplo, si quieres tener un texto en tu página web y ofrecerlo en .pdf para descarga, puedes generar el archivo .md que generará los otros dos. Si necesitas cambiar algo sólo necesitas editar el .md y generar nuevos .html y.pdf
- Tiene las ventajas asociadas a trabajar en texto plano:
- Editable en cualquier SO con casi cualquier editor del sistema
- Alta capacidad de compresión
- No depende de software privativo (como un archivo .docx, por ejemplo)
- Se entiende muy bien con herramientas de control de código como Git o Subversion
- Markdown es una sintaxis que mezcla contenido con formato de una manera poco invasiva, es decir, t
- iene lo suficiente para que el texto pueda ser procesado por una máquina pero l
- a introducción de marcas para formateo es fácilmente legible por un humano.
Desventajas
- Aprender a escribir los archivos bien formateados. Si bien, lo básico (encabezados, negrita, cursiva y bolos) es muy sencillo e intuitivo.
- Sucede a veces que el previo de Dillinger no se corresponde exactamente con la salida de pandoc (normalmente porque Dillinger es más permisivo con la sintaxis)
- Privacidad. No olvidemos que permitimos el uso de nuestro Dropbox. Como siempre: uno debe ser responsable de saber dónde y con quién comparte su información y decidir en consecuencia.
- Para convertir directamente a .pdf con pandoc se necesita pdflatex (MikTex para Windows sirve, por ejemplo). Si no, habrá que pasar por algún software intermedio que imprima o exporte a este formato.
Conclusión
Creo que merece la pena echarle un ojo a la combinación, sobre todo si eres de los más ancestrales del lugar y recuerdas cosas como el maquetado en Wordstar y similares. Si también acostumbras a generar documentación en múltiples formatos, es muy interesante. Para mí, sobre todo, el poder usar una archivo fuente para mis documentos (al igual que con LaTeX) y así poder integrar la documentación en Git, me resulta muy práctico. ¿Le echas un ojo y me cuentas?