PreviewMD para Mac, iPad y iPhone
Obtener

Qué es Markdown, de dónde viene y para qué sirve

Respuesta corta: Markdown es una forma de escribir texto con formato en un archivo de texto plano, con marcas que una persona puede leer sin ningún programa. Una línea que empieza por # es un encabezado, **like this** es negrita, una línea que empieza por - es un elemento de lista. Un conversor lo convierte en HTML; una persona lo lee igual de bien de las dos maneras. Esa doble vida — legible como texto, renderizable como documento — es toda la idea, y la razón por la que ha sobrevivido a todos los formatos más sofisticados que fueron llegando para sustituirlo.

De dónde viene

Markdown se publicó en marzo de 2004 de la mano de John Gruber, que lo escribió con Aaron Swartz. La implementación era un script de Perl de unas 1 400 líneas llamado Markdown.pl, y el objetivo se declaró sin rodeos: quien escribía para la web estaba cansado de teclear etiquetas HTML a mano, y el correo electrónico ya había enseñado a todo el mundo a marcar el texto de manera informal.

Esa última parte importa, porque Markdown no inventó sus marcas. Las recogió de convenciones que la gente ya usaba en el correo de texto plano:

  • rodear una palabra de asteriscos para enfatizarla, algo que usenet y el correo llevaban veinte años haciendo
  • citar una respuesta poniendo > delante de cada línea, como hacía cualquier cliente de correo
  • subrayar un encabezado con === o ---, que venía de Setext, un formato de 1992 de Ian Feldman
  • poner # delante de un encabezado, que venía de atx, escrito por Aaron Swartz en 2002

La aportación de Gruber fue la selección y la regla que hay detrás: un documento Markdown debe leerse como un documento de texto, no como un documento cubierto de etiquetas. Nada en la sintaxis debería parecer marcado a un lector que no sabe que Markdown existe.

El nombre es una broma a costa de markup, y la licencia original era lo bastante permisiva para que cualquiera pudiera reimplementarlo, que es lo que hizo todo el mundo.

Por qué se extendió

Markdown llegó sin comité, sin empresa y sin estándar, y aun así acabó en todas partes. Lo consiguieron tres propiedades.

Es texto plano, así que todas las herramientas ya saben tratarlo. El control de versiones puede compararlo línea a línea y mostrarte qué cambió dentro de un párrafo; prueba a hacer eso con el archivo de un procesador de textos. La búsqueda lo encuentra. Un script puede generarlo. Sobrevive a que lo manden por correo, a que lo peguen en un chat y a que lo vuelvan a copiar. Dentro de cuarenta años seguirá abriéndose.

Aprenderlo cuesta unos cinco minutos. Con tres marcas ya eres productivo, y el resto lo descubres cuando te hace falta. Nada se esconde detrás de una barra de herramientas.

Se degrada con elegancia. Quien no tenga un renderizador de Markdown verá asteriscos y almohadillas, pero seguirá leyendo el texto en el orden correcto, con la estructura a la vista. Eso no pasa con ningún formato binario.

Las plataformas que lo adoptaron temprano lo convirtieron en lo normal. Stack Overflow nació en 2008 con un editor Markdown. GitHub renderizaba README.md en las páginas de los proyectos, y de ahí «escribe tu README en Markdown» pasó a ser la convención de un sector entero. Jekyll, publicado ese mismo año, convertía carpetas de archivos Markdown en sitios web, y GitHub Pages los servía gratis.

En 2016 el formato era ya lo bastante común para registrarse en la IANA como el tipo de medio text/markdown, en el RFC 7763.

Los sabores, y por qué hay varios

La descripción original de Gruber dejaba casos sin definir: qué pasa cuando se interrumpe una lista, cómo se anida el énfasis dentro de una palabra, qué significa un corchete suelto. Cada implementación los resolvió a su manera, así que el mismo archivo se veía distinto en herramientas distintas.

En 2014, un grupo en el que estaba John MacFarlane, autor de Pandoc, escribió una especificación precisa con su batería de pruebas. Se publicó como «Standard Markdown», Gruber se opuso al nombre y pasó a llamarse CommonMark. Esa especificación es la que sigue hoy la mayoría de los renderizadores.

Sabor Qué añade Dónde te lo encuentras
CommonMark La base precisa: reglas sin ambigüedad y una batería de pruebas La mayoría de bibliotecas y editores
GitHub Flavored Markdown Tablas, listas de tareas, tachado, enlaces automáticos, notas al pie, bloques de aviso GitHub, GitLab, casi todos los README
MultiMarkdown Citas, referencias cruzadas, metadatos, tablas mejores Escritura académica y textos largos
Pandoc Markdown Todo lo anterior más matemáticas, figuras y salida a PDF, Word y LaTeX Artículos, libros, tesis
MDX Componentes escritos en JSX, incrustados en el texto Sitios de documentación hechos con React

GFM es lo que la mayoría quiere decir hoy cuando dice Markdown: es CommonMark más las extensiones que GitHub especificó en 2017. PreviewMD renderiza GFM, con las matemáticas de KaTeX y los diagramas de Mermaid.

Para qué lo usa la gente

Documentación y README. Lo normal para cualquier cosa que lea quien programa: readmes de proyecto, registros de cambios, notas de arquitectura, manuales de operación. Los sitios de documentación — MkDocs, Docusaurus, Hugo, Astro — son sobre todo carpetas de Markdown con un tema por encima.

Notas. Obsidian, Bear, iA Writer, Logseq y una docena más guardan las notas como archivos Markdown, lo que significa que tus notas no están atrapadas: puedes leerlas con cualquier editor, respaldarlas con cualquier herramienta y mudarte a otra app sin pasar por una exportación.

Escribir para la web. Sitios estáticos, boletines y blogs donde quien escribe quiere escribir prosa y no marcado. El texto que estás leyendo es un archivo Markdown; el selector de arriba te lo muestra.

Cualquier sitio donde una caja de texto acepte formato. Los gestores de incidencias, las pull requests, las apps de chat, los foros y los wikis usan Markdown o un pariente cercano.

Hablar con máquinas. Los modelos de lenguaje emiten Markdown por omisión, lo que lo ha convertido discretamente en la lengua franca entre las personas y las herramientas de IA: los encabezados, las listas y los bloques de código que ves en la respuesta de un asistente son Markdown renderizado.

En qué no es bueno

Markdown es un formato de estructura, no de maquetación. No tiene manera de decir dónde se coloca algo en la página, qué ancho tiene una columna o qué tipografía usar, y es a propósito: esas decisiones pertenecen a lo que renderice el documento.

Así que encaja mal cuando lo que importa es la forma de la página: un folleto, un formulario, una doble página de revista. Las tablas complejas con celdas combinadas resultan incómodas y casi siempre acaban en HTML. Y para la escritura académica con citas y referencias cruzadas, el Markdown a secas no basta por sí solo: para eso existen las extensiones de Pandoc y de MultiMarkdown.

La queja habitual — «mi archivo se ve distinto en otra app» — es casi siempre una diferencia de sabor. Escribir en CommonMark más GFM es la apuesta más segura, porque es lo que más herramientas tienen en común.

Markdown en un Mac

macOS no renderiza .md de fábrica: la barra espaciadora muestra texto plano, y una carpeta de notas parece un montón de iconos en blanco idénticos.

PreviewMD arregla exactamente esa parte: vistas previas en Quick Look, miniaturas de documento y una ventana con la página renderizada junto a su fuente. Renderiza GitHub Flavored Markdown, con las matemáticas de KaTeX y los diagramas de Mermaid incluidos dentro, así que no se descarga nada mientras se renderiza un documento.

La chuleta enumera cada marca con lo que produce, y cómo abrir un archivo .md en un Mac cubre la parte práctica.