• Markdown es un lenguaje de marcas creado en 2004 por John Gruber. NOTA: 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.
• Markdown 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.

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

• R Markdown: para el lenguaje R.
• GitHub Flavored Markdown: para el sitio GitHub.
• Python Markdown: para el lenguaje Python.
• Pandoc’s Markdown: para el programa Pandoc de conversión entre formatos.
• Kramdown: para el lenguaje Ruby.

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

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

• Encabezados.
• Estilos (ej. negritas, itálicas).
• Citas textuales.
• Enlaces a otros documentos (ej. páginas web).
• Imágenes.
• Listas.

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.

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

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

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

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.

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.

Se definen con números antes de cada elemento.

Se definen con guiones antes de cada elemento.

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

• Guía de referencia de Markdown: Markdown Guide
• Tutorial sobre Markdown: Markdown Tutorial

• Sitio oficial de Markdown: Daring Fireball: Markdown
• Página en Wikipedia sobre Markdown: Markdown - Wikipedia
• Guía de referencia de Markdown: Markdown Guide
• Ficha de ayuda de GitHub Markdown: Markdown Cheatsheet
• Tutorial sobre Markdown: Markdown Tutorial