2.3. Markdown

Una variante en auge de los lenguajes de marcado son los denominados lenguajes de marcado ligero (Lightweight Markup Language). Se diferencian porque los lenguajes de marcado de la familia de XML usan etiquetas estructuradas para identificar los elementos componentes de un documento (véase apartado 2.x), mientras que el marcado ligero se utilizan símbolos tipográficos o estructuras sencillas de símbolos y texto, como “:”, “#”, “*”, “[]” y similares. Además, los lenguajes de marcado ligero pretenden que el contenido original sea fácilmente comprensible, sin que las marcas usadas sean impedimento para la legibilidad. En consecuencia, se trata de lenguajes orientados a la producción de documentos, no al intercambio de datos.

El nacimiento de los lenguajes de marcado ligero se sitúa generalmente en 2004, con la aparición de Markdown, de J. Gruber, al que siguieron Textile, AsciiDOC, reStructuredText… El objetivo de estos marcados ligeros era simplificar y acelerar la producción de documentación digital, de ahí que su uso principal haya sido en entornos de programación. Sin embargo, la facilidad de uso y su sencilla curva de aprendizaje ha hecho que se hayan adoptado ampliamente como base para las aplicaciones de anotación, y como lenguaje de marcado para la creación de documentos maestros, de los cuales generar, posteriormente, versiones en diferentes formatos digitales (procesadores de texto, HTML, PDF, EPUB…). También se han extendido a los entornos de gestión de contenidos para la creación de webs, de tal forma que, por ejemplo, Wordpress, entre otros, acepta el uso de Markdown para la creación de entradas y páginas.

Videotutorial: Javier Cristóbal Gutiérrez. Aprende Markdown RÁPIDO! - Sintaxis básica en menos de 5 MIN. 2018.

La edición de documentos en Markdown puede hacerse con un simple editor de ficheros de texto plano, aunque es más recomendable usar alguno de los editores específicos que ofrecen soporte específico para Markdown (véase apartado 3.3). Los documentos etiquetados con marcado ligero, no sólo en Markdown, necesitan de una aplicación que haga la transformación a un formato legible. Esta tarea es llevada a cabo por los llamados generadores de documentación. El flujo de trabajo básico para elaborar documentación usando un lenguaje de marcado ligero como Markdown es sencillo:

1. En primer lugar, el proceso de edición sólo requiere de un editor de texto, aunque es preferible emplear editores específicos para los lenguajes de marcado ligero.
2. Todo documento necesita que se utilice una herramienta de software capaz de leer el texto y las marcas, interpretarlo y procesarlo de de acuerdo a unas reglas, los generadores de documentación (véase apartado 3.4).
3. A los procesadores o generadores se les provee con el fichero (o ficheros) de texto marcado, el fichero de configuración, el formato de salida, y la hoja de estilo o plantilla a utilizar.
4. Los generadores crean el documento o documentos resultantes, con su estructura organizativa si así se ha indicado, informando con mayor o menor detalle, según la configuración, de los resultados del proceso y de los posibles errores.
5. El documento resultante está preparado para su publicación y distribución en internet, bien como un sitio web estático, bien en otros formatos legibles por máquina.

Fig. 5. Marcado en Markdown y aspecto final en HTML

Esto incide en la rapidez de elaboración y actualización: en caso de introducir cambios, basta con retocar el documento maestro en Markdown, y ordenar al generador de vuelva a generar, valga la redundancia, nuevas versiones de los documentos resultantes, tarea que se lleva a cabo en segundos. El potencial de Markdown ha hecho que se use como lenguaje de documententación en repositorios como Github, o para ampliar las prestaciones de paquete estadístico R. Sin embargo esta expansión y desarrollo también ha propiciado que haya varios "sabores" de Markdown, con cambios en lagunas etiquetas o marcas, lo que en ocasiones pueden ocasiones problemas en la generación de los documentos finales.

_{Financiado por el Ministerio de Educación y Formación Profesional y por la Unión Europea - NextGenerationEU}