leccion-02-markdown

La sintaxis Markdown

1. Acerca de Markdown

Markdown es un lenguaje de marcas creado en 2004 por John Gruber. Las “marcas” se utilizan para brindar información acerca de la presentación (ej. negritas, itálicas) o la estructura (ej. títulos, encabezados) de un documento. Se caracteriza por ser más sencillo de leer y de usar que otros lenguajes de marcas (ej. HTML). Los documentos escritos en Markdown pueden exportarse a una gran variedad de formatos (ej. HTML, Doc, PDF, Latex) para ser usados en libros, presentaciones o páginas web, entre otros. Markdown es ampliamente utilizado en comunicación científica, documentación de programas e investigación reproducible.

2. Variaciones

Las variaciones de Markdown, también llamadas flavors, son extensiones o modificaciones de la especificación original. Entre las más populares están:

Puede verse una lista más extensa en https://github.com/commonmark/commonmark-spec/wiki/markdown-flavors.

3. Sintaxis

La sintaxis de Markdown permite especificar diferentes componentes de un documento, entre los que están:

Encabezados

Pueden definirse seis niveles de encabezados, con los símbolos de numeral (#) antes del texto. El primer nivel es el más grande y el sexto el más pequeño. A la izquierda se muestra la sintaxis Markdown y a la derecha la forma en que se despliega en un documento.

3.1. Sintaxis de Markdown - itálicas

Se definen con un asterisco (*) antes y después del texto o con un guión bajo (_) antes y después del texto.

3.2. Sintaxis de Markdown - negritas

Se definen con dos asteriscos (**) antes y después del texto o con dos guiones bajos (__) antes y después del texto.

3.3. Sintaxis de Markdown - citas textuales

Se definen con un símbolo de “mayor que” (>) antes de cada línea.

3.4. Sintaxis de Markdown - enlaces a otros documentos

Se definen con un paréntesis cuadrados[] seguidos de paréntesis redondos (). En los paréntesis cuadrados se coloca (opcionalmente) el texto del enlace y en los redondos la dirección del documento.

3.5. Sintaxis de Markdown - imágenes

Se definen con un signo de admiración de cierre (!), paréntesis cuadrados[] y paréntesis redondos (). En los paréntesis cuadrados se coloca (opcionalmente) un texto para la imagen y en los redondos la dirección de la imagen, ya sea en el disco o en la red.

3.6. Sintaxis de Markdown - listas numeradas

Se definen con números antes de cada elemento.

3.7. Sintaxis de Markdown - listas no numeradas

Se definen con guiones antes de cada elemento.

3.8. Otros elementos de sintaxis

Para conocer otros elementos de la sintaxis de Markdown, se recomienda revisar en detalle:

4. Recursos