Markdown: in­tro­du­c­ción al lenguaje de marcado

Cuando leemos un texto, ya sea en Internet, en una revista o en un libro impreso, esperamos un formato de­te­r­mi­na­do: las palabras im­po­r­ta­n­tes están en negrita, los títulos se di­s­ti­n­guen del resto del texto de un vistazo y las listas lo es­tru­c­tu­ran y permiten verlo más cla­ra­me­n­te. Todos damos por hecho el uso de estos formatos y, cuando nosotros mismos es­cri­bi­mos un texto en el ordenador, en general los aplicamos sin problemas; ajustamos el tamaño de la fuente, es­ta­ble­ce­mos puntos de viñeta o ponemos palabras en negrita. Cualquier pro­ce­sa­dor de textos ofrece a los usuarios gran variedad de po­si­bi­li­da­des para crear textos vi­sua­l­me­n­te más atra­c­ti­vos.

Sin embargo, no es un concepto tan obvio como parece. En principio, con este tipo de software marcamos el texto y el programa nos lo muestra a nuestro gusto, de manera que el texto fuente real, in­clu­ye­n­do elementos de marcado (o etiquetas), no es visible ni en Word ni en el resto de pro­ce­sa­do­res de texto. De todas formas, a la mayoría tampoco nos serviría de mucho, ya que son pocas las personas que saben leer este código.

Cualquier editor de texto nos permite escribir en lenguajes como HTML o LaTeX, pero no hay mucha gente que los domine. El lenguaje de marcado si­m­pli­fi­ca­do Markdown pretende so­lu­cio­nar este problema y ofre­ce­r­nos lo mejor de ambos mundos: ser co­m­pre­n­si­ble tanto para las máquinas como para las personas. Markdown utiliza elementos muy in­tui­ti­vos para dar formato, de modo que los textos marcados con esta sintaxis resultan re­la­ti­va­me­n­te fáciles de leer para todo el mundo.

Al igual que HTML o LaTeX, Markdown es un lenguaje de marcado, pero, a di­fe­re­n­cia de estos, pretende ofrecer la máxima facilidad de lectura al usuario. Sus comandos de fo­r­ma­tea­do no son ab­s­tra­c­tos, sino cercanos al si­g­ni­fi­ca­do real. Se entiende mejor con un ejemplo: en HTML, para enfatizar una palabra en negrita, se utilizan las etiquetas '<b>' o '<strong>'.

Si escribes un documento en LaTeX, utiliza (en el modo texto continuo) el elemento \textbf.

Ambas versiones son re­la­ti­va­me­n­te fáciles de leer, aunque un poco más difíciles de escribir, es­pe­cia­l­me­n­te cuando se trata de textos más largos. Markdown lo si­m­pli­fi­ca, pe­r­mi­tie­n­do poner los fra­g­me­n­tos en negrita entre as­te­ri­s­cos.

Por un lado, esta versión es más fácil de leer, porque el asterisco permite di­s­ti­n­guir el texto resaltado de un vistazo, y por el otro, los cuatro ca­ra­c­te­res son mucho más rápidos de escribir que las etiquetas. Incluso antes de la co­n­ve­r­sión (es decir, viendo el texto sin formato), el lector puede intuir fá­ci­l­me­n­te cuál es la intención del autor, incluso si no conoce la sintaxis de Markdown.

Por lo tanto, Markdown es es­pe­cia­l­me­n­te in­te­re­sa­n­te para los usuarios que no tienen ex­pe­rie­n­cia en TIC ni co­no­ci­mie­n­tos de diseño web, pero que suelen escribir textos en Internet con re­gu­la­ri­dad, como, por ejemplo, los bloggers que trabajan con sistemas de gestión de co­n­te­ni­dos (CMS, por sus siglas en inglés). No obstante, también los pro­fe­sio­na­les de la te­c­no­lo­gía recurren al lenguaje Markdown para escribir textos simples. Es el caso de los pro­gra­ma­do­res que lo emplean para escribir do­cu­me­n­tos co­m­ple­me­n­ta­rios (como archivos léeme o Readme) que, en principio, no van a co­n­ve­r­ti­r­se. Tanto si el usuario abre el texto en un visor de Markdown como si lo ve como texto sin formato, no habrá mucha di­fe­re­n­cia en términos de le­gi­bi­li­dad.

Para los CMS más populares, como WordPress o Joomla, existen plugins que permiten a los sistemas in­te­r­pre­tar Markdown. También muchas wikis, foros (como, por ejemplo, Reddit) y el generador de sitios web Jekyll son co­m­pa­ti­bles con este sencillo lenguaje de marcado.

Markdown no pretende ser un sustituto de HTML, ya que su rango de opciones de formateo es demasiado reducido. Los de­sa­rro­lla­do­res del lenguaje co­n­si­de­ran a Markdown más bien como un co­m­ple­me­n­to. Si quieres, puedes insertar elementos HTML en un documento de Markdown para ampliar el rango del lenguaje, que es re­la­ti­va­me­n­te simple, aunque el lenguaje Markdown debería servir para facilitar la escritura (es­pe­cia­l­me­n­te en Internet). Cuando los do­cu­me­n­tos Markdown son co­n­ve­r­ti­dos por el ana­li­za­dor, pueden generarse, por ejemplo, archivos HTML que permiten vi­sua­li­zar­los en los na­ve­ga­do­res.

Dado que este lenguaje de marcado pretende ser lo más sencillo posible, la sintaxis de Markdown casi se explica por sí misma. No obstante, para poder utilizar co­rre­c­ta­me­n­te todos los elementos de marcado, primero debes co­no­ce­r­los. A co­n­ti­nua­ción, te ex­pli­ca­mos las funciones más im­po­r­ta­n­tes.

Crear negritas y cursivas con Markdown es pa­r­ti­cu­la­r­me­n­te fácil, ya que solo son ne­ce­sa­rios los as­te­ri­s­cos. Para poner una palabra o grupo de palabras en cursiva, inserta un asterisco antes y después de ellas. Para la negrita, utiliza dos. Si deseas remarcar un área de texto en negrita y cursiva, pon tres as­te­ri­s­cos. Como al­te­r­na­ti­va, también puedes utilizar guiones bajos.

Para re­pre­se­n­tar un texto tachado en Markdown, escribe dos vi­r­gu­li­llas seguidas; después, escribe el texto co­rre­s­po­n­die­n­te y ciérralo con otras dos vi­r­gu­li­llas.

Para crear un título en Markdown, se utiliza de forma pre­de­te­r­mi­na­da una al­moha­di­lla, que se pone delante del texto, separada por un espacio en blanco. Para crear su­b­tí­tu­los y, por lo tanto, en letra más pequeña, se insertan más al­moha­di­llas. De esta manera, se pueden crear hasta seis niveles de títulos, como en HTML.

Si lo prefieres, también puedes utilizar el guion y el signo de igual para marcar en­ca­be­za­dos, que deberás colocar en la línea que hay debajo del texto co­rre­s­po­n­die­n­te. Uti­li­za­n­do esta opción, solo se pueden generar dos tamaños de en­ca­be­za­do distintos. Con insertar un carácter por título es su­fi­cie­n­te, aunque a menudo los autores escriben varios ca­ra­c­te­res seguidos, por razones puramente visuales. Así, el texto da la impresión de estar subrayado una o dos veces.

En el lenguaje Markdown, uti­li­za­mos líneas vacías para separar los párrafos. Para crear un bloque de texto co­m­ple­ta­me­n­te nuevo (etiqueta), si­m­ple­me­n­te se introduce una línea en blanco. Es im­po­r­ta­n­te tener en cuenta que para Markdown es su­fi­cie­n­te si la línea está vi­sua­l­me­n­te vacía. Por lo tanto, si contiene ca­ra­c­te­res en blanco, como ta­bu­la­cio­nes o espacios, el ana­li­za­dor los ignorará e in­te­r­pre­ta­rá que la línea está vacía. Si deseas insertar un salto de línea como el de la etiqueta
, introduce dos espacios al final de la línea.

Para marcar un fragmento de texto como una cita en Markdown, puedes crear las llamadas citas en bloque, uti­li­za­n­do el signo de mayor que (>). Tienes dos opciones: marcar cada línea in­di­vi­dual con este carácter o insertar úni­ca­me­n­te uno al principio del párrafo de la cita sangrada y marcar el fin de la cita in­tro­du­cie­n­do una línea en blanco. La cita en bloque, a su vez, puede ser fo­r­ma­tea­da con otros elementos.

Para crear una lista no ordenada en Markdown, puedes utilizar el signo de más, un guion o un asterisco. Con las tres opciones obtendrás el mismo resultado.

Si lo que quieres es crear una lista ordenada, deberás in­tro­du­cir un número con un punto di­re­c­ta­me­n­te después.

Asimismo, Markdown te da la opción de crear listas de ve­ri­fi­ca­ción, que vienen con casillas que pueden activarse haciendo clic sobre ellas. Si quieres, puedes marcar di­re­c­ta­me­n­te las casillas al crear la lista. Para ello, utiliza corchetes y una X.

Para marcar un área de texto como código, Markdown utiliza el llamado acento grave, que no debe co­n­fu­n­di­r­se con la comilla simple. Se pone un acento al principio y otro al final del área de texto co­rre­s­po­n­die­n­te para de­li­mi­tar­la. De esta manera, el código fuente o los comandos de software se pueden insertar di­re­c­ta­me­n­te en el texto.

Si el acento grave también aparece en el propio código, puedes in­tro­du­cir el carácter dos veces al principio de la sección de código. De esta manera, Markdown no ide­n­ti­fi­ca­rá dicho acento grave como marca.

Para marcar un bloque completo como código fuente, inserta una ta­bu­la­ción o cuatro espacios en blanco en cada línea. Si deseas sangrar más algunas líneas, solo tienes que añadir más ta­bu­la­cio­nes o espacios.

Si eres de los que prefieren utilizar ca­ra­c­te­res para iniciar y finalizar los bloques de código, también puedes marcar el área co­rre­s­po­n­die­n­te in­se­r­ta­n­do tres acentos graves al principio y al final. Asimismo, muchos editores de Markdown ofrecen la opción de resaltar el texto au­to­má­ti­ca­me­n­te con colores. Para hacerlo, justo después de los tres acentos graves, es­pe­ci­fi­ca el lenguaje del código fuente en que está escrito el texto.

Con Markdown también puedes insertar imágenes e hi­pe­r­ví­ncu­los en tu texto. Ambos se in­tro­du­cen mediante una co­m­bi­na­ción de corchetes y pa­ré­n­te­sis. Para crear un enlace, debes escribir el texto de anclaje –es decir, las palabras o frases que se verán en el texto– entre corchetes y añadir el URL di­re­c­ta­me­n­te después entre pa­ré­n­te­sis. Además, si deseas añadir al hi­pe­r­ví­ncu­lo un título opcional que el usuario verá cuando desplace el ratón sobre él, solo tienes que escribir el texto entre pa­ré­n­te­sis y entre comillas dobles, separado del URL por un espacio.

Si insertas un URL o una dirección de correo ele­c­tró­ni­co en el texto principal, la mayoría de los editores de Markdown crearán au­to­má­ti­ca­me­n­te un hi­pe­r­ví­ncu­lo se­le­c­cio­na­ble. Para im­ple­me­n­tar­lo, utiliza los ca­ra­c­te­res de menor que y mayor que. Marcando el URL como código con los acentos graves, como es habitual, evitarás que el editor lo im­ple­me­n­te au­to­má­ti­ca­me­n­te.

Al igual que los hi­pe­r­ví­ncu­los, en los do­cu­me­n­tos Markdown también se pueden insertar imágenes. En este caso, primero tendrás que poner un signo de ex­cla­ma­ción. Después, deberás escribir el texto al­te­r­na­ti­vo de la imagen entre corchetes y el URL que dirige a la imagen entre pa­ré­n­te­sis. Esta se mostrará di­re­c­ta­me­n­te en el texto.

También es posible combinar imágenes e hi­pe­r­ví­ncu­los. Si deseas insertar un enlace en el que se pueda hacer clic detrás de la imagen, puedes anidar una función dentro de la otra. En este caso, la imagen se co­n­ve­r­ti­rá en un texto de anclaje y, por lo tanto, deberá figurar entre corchetes.

Markdown permite dibujar tablas mediante plecas (|). Cada celda está separada por uno de estos ca­ra­c­te­res. Para crear en­ca­be­za­dos que se distingan vi­sua­l­me­n­te del resto del contenido, se subrayan las celdas co­rre­s­po­n­die­n­tes con guiones.

Lo cierto es que no importa si las plecas están una debajo de la otra: esto solo facilita la le­gi­bi­li­dad cuando se ve el documento Markdown en su versión sin formato. Lo mismo se aplica a las plecas que aparecen a los lados, que también son irre­le­va­n­tes en términos de co­m­pi­la­ción.

Markdown también ofrece la po­si­bi­li­dad de in­co­r­po­rar notas al pie. Para ello, escribe un número de nota en el texto y refiérelo a una nota al pie al final de la página: se generará au­to­má­ti­ca­me­n­te la línea co­rre­s­po­n­die­n­te. El número de nota también se formatea como un hi­pe­r­ví­ncu­lo, que nos lleva di­re­c­ta­me­n­te a la nota al pie co­rre­s­po­n­die­n­te al hacer clic en él. Para utilizar esta función au­to­má­ti­ca, deberás insertar el número de la nota detrás de la palabra que desees. Para ello, escribe entre corchetes un acento ci­r­cu­n­fle­jo y, después, el número.

El número que utilices (se admiten también otros elementos) es irre­le­va­n­te. Al igual que con la creación de listas, Markdown realiza el conteo au­to­má­ti­ca­me­n­te. Sin embargo, es im­po­r­ta­n­te que vuelvas a in­tro­du­cir la misma de­no­mi­na­ción. Para ello, pon el mismo número en una nueva línea, de nuevo entre corchetes y precedido por un acento ci­r­cu­n­fle­jo, inserta dos puntos y, luego, escribe el texto de la nota. Este, a su vez, también podrá fo­r­ma­tear­se de todas las maneras posibles y ocupar varias líneas.

Debido a que Markdown está es­tre­cha­me­n­te re­la­cio­na­do con HTML, el signo de et (&), así como los de mayor que y menor que, tienen una gran im­po­r­ta­n­cia. Estos ca­ra­c­te­res se utilizan en HTML para abrir y cerrar etiquetas (<>) y para trabajar con entidades (&). En HTML, si deseas utilizar los ca­ra­c­te­res con su si­g­ni­fi­ca­do original, debes en­ma­s­ca­rar­los: &, < y >. En principio, en Markdown no hay ninguna razón para no poder utilizar los signos li­te­ra­l­me­n­te. Sin embargo, como existe la opción de combinar Markdown con HTML, la cosa se puede complicar un poco. Para que los usuarios no tengan que resolver este problema ellos mismos, el ana­li­za­dor comprende cuándo son ca­ra­c­te­res simples y cuando se está uti­li­za­n­do el código HTML.

Además de los ca­ra­c­te­res es­pe­cí­fi­cos co­rre­s­po­n­die­n­tes a HTML, Markdown utiliza ciertos símbolos para el marcado. Si se utilizan, el ana­li­za­dor reac­cio­na­rá cuando realice la co­n­ve­r­sión. Son los si­guie­n­tes:

• Asterisco: *
• Guion: -
• Guion bajo: _
• Pa­ré­n­te­sis: ()
• Corchetes: []
• Llaves: {}
• Punto: .
• Signo de ex­cla­ma­ción: !
• Al­moha­di­lla: #
• Acento grave: `
• Barra invertida: \

Para utilizar estos ca­ra­c­te­res en sentido literal, solo debes insertar una barra invertida delante de cada uno de ellos. Es im­po­r­ta­n­te escribir la barra invertida antes de cada carácter, por ejemplo, tanto delante del pa­ré­n­te­sis de apertura como del de cierre.