# 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 a**doptado 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.

<iframe allowfullscreen="allowfullscreen" height="336" src="https://www.youtube.com/embed/y6XdzBNC0_0" width="600"></iframe>

**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](https://libros.catedu.es/books/etiquetados-para-creacion-de-contenidos-en-internet/page/33-herramientas-editores)). 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](https://libros.catedu.es/books/etiquetados-para-creacion-de-contenidos-en-internet/page/34-herramientas-generadores-de-sitios-web)).
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**.

[![markdown.png](https://libros.catedu.es/uploads/images/gallery/2023-01/scaled-1680-/markdown.png)](https://libros.catedu.es/uploads/images/gallery/2023-01/markdown.png)

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*](https://www.r-project.org/). 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.

<details id="bkmrk-material-complementa"><summary>Material complementario</summary>

- Cristóbal J. [*markdown.es*](https://markdown.es/). 2016
- Lázaro, E. [*Tutorial Markdown*](https://tutorialmarkdown.com/guia). 2023.

</details>{{@5685}}