Roger Casadejús PérezFull stack web developer y SEO + miembro del blueteam en ciberseguridad web
Qué es el lenguaje de formato markdown y cómo usarlo en mac
Si trabajas con un Mac y escribes a menudo, seguramente te has topado más de una vez con términos como Markdown, texto plano o lenguaje de marcado ligero. Puede sonar muy técnico, pero en realidad Markdown es una herramienta sencilla que puede cambiar por completo la forma en la que tomas notas, redactas documentos o preparas contenido para la web. La idea es simple: escribes como siempre, en un editor de texto normal, pero añadiendo unos pocos símbolos muy fáciles de recordar para indicar negritas, cursivas, títulos, listas, enlaces, tablas o imágenes. Luego, con un clic, conviertes ese texto en HTML, PDF, Word o lo que necesites.
Qué es exactamente el lenguaje de formato markdown
Markdown es un lenguaje de marcado ligero basado en texto plano creado en 2004 por John Gruber con la ayuda de Aaron Swartz. Su propósito original era permitir escribir documentos que fuesen fáciles de leer directamente en texto plano, pero que al mismo tiempo pudieran convertirse de forma automática a HTML válido para la web. Cuando hablamos de Markdown solemos referirnos a dos cosas: por un lado, a la forma de escribir usando una sintaxis mínima (asteriscos, almohadillas, guiones, etc.); por otro, a las herramientas o motores que se encargan de transformar ese texto en HTML, PDF, DOCX u otros formatos. Tú solo te preocupas de escribir; el programa hace la conversión.
Una de las grandes ventajas es que, al estar todo en texto plano, tus archivos son legibles en cualquier dispositivo y resistirán mucho mejor el paso del tiempo que un documento de un procesador de textos propietario. Un .md (la extensión típica de Markdown) se abre igual de bien en macOS, Windows, Linux, iOS, Android o incluso en un navegador. Si te interesa trabajar con opciones multiplataforma, puedes leer sobre opciones multiplataforma que facilitan ese flujo. Además, la sintaxis está pensada para que el resultado siga siendo cómodo de leer incluso sin “renderizar”. No es como el HTML, donde las etiquetas llenan la pantalla. En Markdown, la marca de formato casi no molesta: si ves un texto entre asteriscos, ya sabes que está enfatizado; si ves varias almohadillas al principio de una línea, intuyes que se trata de un encabezado. Por si fuera poco, a los programas les resulta muy fácil procesar este tipo de archivos.
Origen, evolución y variantes de markdown
John Gruber publicó Markdown en 2004 con un objetivo muy concreto: evitar que los autores tuvieran que pelearse con el HTML cada vez que quisieran dar formato a un texto para la web. Lo acompañó de un script en Perl capaz de convertir automáticamente esa sintaxis sencilla en HTML bien formado. Con el tiempo, la comunidad empezó a necesitar más cosas: tablas, notas al pie, definiciones, etc. Así surgieron extensiones como Markdown Extra, que añadió varias funcionalidades útiles, especialmente para documentación técnica y textos largos.
En paralelo fueron apareciendo otras variantes y sabores. GitHub Flavored Markdown (GFM) es muy usado en repositorios de código; CommonMark, un intento de crear una especificación más estricta y estándar que redujese las ambigüedades entre implementaciones. Esta diversidad ha sido arma de doble filo. Por un lado, ha permitido incorporar nuevas características como tablas, tareas con casillas de verificación o bloques de código enriquecidos. Por otro, puede generar cierta confusión: no todas las implementaciones soportan las mismas funciones ni las interpretan de idéntica manera.
Aun así, la realidad hoy es clara: Markdown se ha consolidado como lenguaje de referencia para documentación técnica, proyectos de software, blogs estáticos y notas personales. En el mundo del desarrollo y la escritura técnica es prácticamente omnipresente, pero también es perfectamente válido para cualquier otro tipo de texto.
Sintaxis básica de markdown: cómo se escribe
La gracia de Markdown es que su sintaxis es muy fácil de aprender y recordar. Se trata simplemente de añadir determinados caracteres en lugares concretos: al principio de una línea, alrededor de una palabra, o separando elementos de una lista. Los archivos se guardan normalmente con la extensión .md o .markdown y puedes editarlos con cualquier editor de texto: TextEdit (en modo texto plano), el Bloc de notas de Windows, Sublime Text, Vim, o editores específicos de Markdown. Incluso muchas plataformas web incorporan ya sus propios editores con vista previa.
Un ejemplo típico: para crear encabezados, se usan almohadillas (símbolo #) delante del texto. Cuantas más almohadillas, más bajo es el nivel del título:
- # Título de nivel 1 (equivalente a h1 en HTML)
- ## Título de nivel 2
- ### Título de nivel 3
- #### Título de nivel 4
Los párrafos se separan con una línea en blanco entre medias. Si simplemente saltas de línea una vez, la mayoría de variantes de Markdown siguen considerándolo el mismo párrafo. Algunas implementaciones requieren dos espacios al final de la línea para forzar un salto de línea manual, aunque en GitHub Flavored Markdown no es necesario. Para enfatizar texto se utilizan principalmente asteriscos o guiones bajos. Un solo símbolo alrededor de una palabra o frase indica cursiva, mientras que dos símbolos marcan la negrita. Así se consigue un formato rápido y muy legible incluso en bruto, sin necesidad de botones ni menús.
Las listas también son muy sencillas: puedes crear listas ordenadas numerando cada línea con un número seguido de un punto, o listas sin ordenar empezando la línea con un guion, un asterisco o un signo más. Con una simple sangría (tabulador o espacios) generas sublistas anidadas sin complicarte la vida.
Elementos habituales de la sintaxis: del texto al código
Más allá de los títulos y párrafos, en el día a día vas a usar Markdown para aplicar énfasis, crear listas, añadir código, citas, imágenes, enlaces o tablas. La sintaxis es siempre coherente y fácil de leer. El énfasis, como se comentaba antes, se consigue marcando el texto con símbolos especiales. Una palabra encerrada entre un solo delimitador se ve en cursiva, mientras que con un delimitador doble resalta en negrita. De esta forma, puedes destacar palabras clave, conceptos importantes o nombres de comandos sin romper el flujo de escritura.
Las listas suponen otro punto fuerte de Markdown. Para una lista sin ordenar basta con iniciar cada línea con un marcador simple. Si quieres una lista ordenada, enumeras cada elemento con su número seguido de un punto. Muchos sabores de Markdown, como el de GitHub, admiten incluso listas con casillas de verificación, muy útiles para tareas o to‑dos.
Cuando necesitas mostrar fragmentos de código, Markdown ofrece dos niveles. Para pequeños trozos incrustados dentro de un párrafo, se utilizan acentos graves alrededor del código. Para bloques completos, se colocan tres acentos graves en una línea antes y después del bloque. El resultado suele mostrarse con una tipografía monoespaciada y fondo diferenciado. Las citas en bloque se marcan anteponiendo un símbolo de mayor que al inicio de la línea. Esta sintaxis permite indicar de forma muy clara que se trata de texto citado o destacado respecto al resto del contenido.
Con los enlaces la cosa es igual de directa. Se escribe el texto visible entre corchetes y, justo a continuación, la URL entre paréntesis. También se pueden definir referencias al final del documento para mantener el cuerpo principal más limpio, reutilizando etiquetas numeradas o con nombre para hacer de nota al pie. Las imágenes se declaran de manera muy parecida a los enlaces, añadiendo un signo de exclamación delante. En Markdown estándar se suele indicar un texto alternativo dentro de los corchetes y la ruta o URL de la imagen entre paréntesis; algunas variantes permiten incluir un título opcional. Esto facilita mucho insertar gráficos, capturas o logotipos sin necesidad de escribir etiquetas HTML a mano.
Por último, aunque el Markdown original no definía tablas, muchas implementaciones modernas (como GitHub Flavored Markdown) permiten crearlas usando barras verticales para separar columnas y una fila de guiones para delimitar el encabezado. Con unos pocos caracteres adicionales puedes especificar alineación a la izquierda, centrada o a la derecha añadiendo dos puntos en la línea del encabezado.
Ventajas de usar markdown en tu día a día
La pregunta lógica es: ¿realmente me compensa aprender esta sintaxis? En la práctica, para cualquiera que escriba a menudo en el ordenador, Markdown aporta una serie de beneficios muy claros en rapidez, comodidad y durabilidad de los documentos.