Markdown está en todas partes, y todo empezó con un README
¿Os habéis dado cuenta de que Markdown se ha convertido poco a poco en el formato de documento de facto?
Yo me di cuenta un poco por casualidad. Un compañero que no escribe ni una línea de código me preguntó por qué su texto salía lleno de almohadillas. Había copiado la respuesta de un asistente de IA en un correo. El Markdown le había llegado sin que supiera qué era.
Durante mucho tiempo, para mí Markdown era el README.md en la raíz de un repo. Hoy me lo encuentro en todas partes, incluso en gente que nunca ha abierto una terminal. Me apetecía tirar del hilo para entender cómo hemos llegado hasta aquí.
2004: un formato pensado para leerse tal cual
John Gruber presentó Markdown el 15 de marzo de 2004 en su blog, Daring Fireball. Aaron Swartz, que entonces tenía 17 años, le ayudó como beta tester. La idea de partida era modesta: escribir para la web sin tener que teclear HTML.
En la práctica, Markdown era un script en Perl pensado como plugin para Movable Type, la herramienta de blog que usaba Gruber. Michel Fortin lo portó a PHP ese mismo primer año, y el propio Gruber recomendaba ese port en la página oficial. Como desarrollador PHP, el detalle me hace gracia: Markdown hablaba nuestro idioma casi desde el principio.
El principio que lo decidió todo es que un fichero Markdown tiene que poder leerse aunque nunca se convierta. Un título con una almohadilla, una lista con guiones, negrita entre asteriscos. Recuperaba costumbres que ya existían en los correos en texto plano y en los foros.
Esa decisión explica que haya durado tanto. Un .md abierto en el Bloc de notas, en vim o en una terminal se sigue entendiendo. Pocos formatos pueden decir lo mismo.
|
Dato |
Detalle |
|---|---|
|
Presentación pública |
15 de marzo de 2004, en Daring Fireball |
|
Creador |
John Gruber |
|
Beta tester |
Aaron Swartz, con 17 años |
|
Primera implementación |
Script en Perl, plugin para Movable Type |
|
Primer port |
PHP, de Michel Fortin |
|
Inspiración principal |
Los correos en texto plano |
2008-2014: el idioma de los desarrolladores
Entre 2008 y 2014, Markdown se convierte en la herramienta de escritura por defecto de los desarrolladores, casi sin que lo eligiéramos.
Stack Overflow lo adopta desde su lanzamiento en 2008. GitHub lo convierte en la base de sus README, y después de sus issues, pull requests y wikis, con su propia variante: GitHub Flavored Markdown. Los generadores de sitios estáticos se suman, y los notebooks de IPython (el futuro Jupyter) lo usan para sus celdas de texto.
|
Año |
Herramienta |
Qué aporta |
|---|---|---|
|
2014 |
MkDocs |
Documentación técnica escrita íntegramente en .md |
|
2014 |
CommonMark |
Una especificación para unificar los dialectos |
|
2013 |
Hugo |
Sitios estáticos en Go, con el contenido en Markdown |
|
2011 |
IPython Notebook |
Texto en Markdown entre las celdas de código |
|
2008 |
Jekyll |
El blog del desarrollador en ficheros .md |
|
2008 |
Stack Overflow |
Preguntas y respuestas redactadas en Markdown |
|
2008 |
GitHub |
README, issues, PR, wikis |
En un repo no nos quedamos en el README. Está el CHANGELOG.md, el CONTRIBUTING.md, el SECURITY.md, y esa carpeta oculta .github que guarda las plantillas de issues y pull requests. Todo lo que rodea al código se escribe en Markdown.
La otra cara es que cada uno añade sus propias extensiones. Tablas, casillas de verificación, bloques de código con resaltado de sintaxis: nada de eso estaba en la versión de 2004. CommonMark nace en 2014 precisamente porque un mismo fichero no se veía igual de una herramienta a otra. Ese problema nunca se ha ido del todo.
2015-2022: con un pie fuera
En esos años, Markdown empieza a salir del repo, pero poco a poco.
Slack y Discord aceptan parte de la sintaxis: negrita, cursiva, código. Notion y otros editores convierten en título una almohadilla escrita al principio de una línea. Obsidian, lanzado en 2020, construye todo su enfoque sobre ficheros .md guardados en local, y atrae a mucha gente que no se dedica al desarrollo.
En 2022, Google Docs empieza a detectar automáticamente la sintaxis Markdown mientras escribes. Es una señal: el formato ya no es solo cosa de técnicos. Pero la mayoría lo usa sin saber que tiene nombre.
|
Herramienta |
Qué hace con Markdown |
|---|---|
|
Slack, Discord |
Parte de la sintaxis: negrita, cursiva, código |
|
Notion |
Convierte la sintaxis escrita en formato |
|
Obsidian (2020) |
Notas guardadas como ficheros .md locales |
|
Google Docs (2022) |
Detección automática mientras escribes |
De 2023 en adelante: la IA hace el resto
Lo que lo aceleró todo fueron los asistentes de IA. Responden en Markdown por defecto: títulos, listas, negritas, tablas, bloques de código. Millones de personas empezaron a leer Markdown a diario, muchas veces sin saberlo.
En julio de 2024, Google Docs añade la importación y exportación en .md, además de la opción de pegar desde Markdown (anuncio de Google Workspace). Google habla sobre todo de redactores técnicos, pero lo aprovecha todo el mundo.
En el código, el Markdown hasta cambia de lector. Ahora escribimos ficheros pensados para agentes de IA y no para personas. Cada herramienta tenía el suyo (CLAUDE.md, .cursorrules, GEMINI.md…), hasta que OpenAI publica AGENTS.md en agosto de 2025 como formato común. En diciembre de 2025, más de 60.000 proyectos open source lo usaban según OpenAI, que lo cedió a la Linux Foundation (anuncio).
El README se escribía para una persona que descubre un proyecto. AGENTS.md se escribe para una máquina que va a trabajar en él. El formato es el mismo.
|
README.md |
AGENTS.md |
|
|---|---|---|
|
Lector |
Una persona |
Un agente de IA |
|
Función |
Presentar el proyecto |
Dar las instrucciones para trabajar en él: instalación, tests, convenciones |
|
Se generaliza |
Con GitHub, a partir de 2008 |
Publicado por OpenAI en agosto de 2025 |
|
Adopción |
Casi todos los repos de GitHub |
Más de 60.000 proyectos open source a finales de 2025 |
El soporte nativo no acompaña
Markdown está en todas partes, pero no en todas partes lo entienden. Ahí es donde se atasca.
Pego una tabla en Markdown en una herramienta y se ve perfecta. En otra, me encuentro barras verticales y guiones desperdigados. Un correo redactado con un asistente de IA le llega al destinatario lleno de asteriscos. Un mismo .md no se ve igual en GitHub, en VS Code y en Obsidian, porque cada uno gestiona sus propias extensiones.
LinkedIn, por ejemplo, no lo interpreta en absoluto. Si quieres negrita en un post, tienes que recurrir a caracteres Unicode, lo que crea otros problemas de accesibilidad.
El problema de los dialectos no es nuevo. En 2014, Jeff Atwood, cofundador de Stack Overflow, y John MacFarlane, creador de Pandoc, publican una especificación con el nombre de «Standard Markdown». Gruber se opone a que la palabra Markdown aparezca en el nombre, y el proyecto pasa a llamarse CommonMark. La versión 1.0 de esa especificación sigue sin publicarse.
El formato se ha vuelto universal a la hora de escribir. A la hora de mostrarlo, cada herramienta sigue yendo por libre.
2025: el Bloc de notas de Windows y Notas de Apple se pasan a Markdown
Es la señal más clara de que Markdown ha salido del mundo de los desarrolladores: los dos editores de texto más básicos, instalados en cientos de millones de equipos, lo adoptaron el mismo año.
El Bloc de notas de Windows lee y escribe Markdown
A finales de mayo de 2025, Microsoft empieza a desplegar entre los Windows Insiders una actualización del Bloc de notas con formato ligero: negrita, cursiva, enlaces, listas, títulos. El Bloc de notas acepta escribir en Markdown y abre ficheros .md. Un botón en la barra de estado permite pasar de la vista con formato a la vista de sintaxis, y la función se puede desactivar en la configuración.
En noviembre de 2025, una nueva versión preliminar añade las tablas, que se insertan desde la barra de herramientas o directamente con sintaxis Markdown.
Para una herramienta que ha sido un simple editor de texto plano durante décadas, el cambio es enorme. Y no pasó desapercibido: parte de los usuarios protestó, porque quería un Bloc de notas sin florituras.
Notas de Apple importa y exporta en Markdown
Apple ha optado por otro enfoque. Con iOS 26, iPadOS 26 y macOS Tahoe 26, Notas puede importar un fichero .md y exportar una nota en Markdown. Los títulos, las listas, los enlaces, la negrita y la cursiva se convierten en texto enriquecido al importar. La documentación actual de Apple también menciona copiar una nota como Markdown y pegar Markdown en Notas.
Eso sí, en Notas no se escribe en Markdown. La conversión se hace a la entrada y a la salida, y entre medias la nota sigue en el formato de Apple.
|
Bloc de notas (Windows) |
Notas de Apple |
|
|---|---|---|
|
Escribir directamente en sintaxis Markdown |
Sí |
No |
|
Alternar entre vista con formato y sintaxis |
Sí |
No |
|
Ficheros .md |
Se abren y editan tal cual |
Se importan, se convierten y se pueden exportar |
|
Tablas |
Sí, en versión preliminar desde noviembre de 2025 |
No especificado |
Cómo están las herramientas para el gran público
|
Herramienta |
Qué hace con Markdown |
Desde |
|---|---|---|
|
Bloc de notas (Windows 11) |
Muestra y edita Markdown, alterna vista con formato / sintaxis, tablas |
2025 |
|
Notas de Apple (iOS 26, macOS Tahoe) |
Importación y exportación .md, conversión a texto enriquecido |
2025 |
|
Google Docs |
Detección al escribir, luego importación, exportación y pegado |
2022, luego 2024 |
|
|
Ningún formato |
Nunca |
Con lo que me quedo: Microsoft ha convertido Markdown en un formato nativo de su editor más sencillo, mientras que Apple lo trata como un formato de intercambio. Dos visiones, y todavía ningún comportamiento común.
¿Y ahora qué?
No creo que lleguemos a ver un Markdown único que se muestre igual en todas partes. El formato ganó precisamente porque era sencillo y cualquiera podía ampliarlo. Esa libertad tiene un precio, y lo pagamos cada vez que copiamos y pegamos.
Lo que me llama la atención es el camino recorrido. Hace veinte años era un truco para no escribir HTML. Hace diez, era nuestro formato, el de los repos. Hoy mis clientes lo reciben sin saberlo, y yo escribo ficheros .md para explicar mis proyectos a agentes de IA.
Mientras las herramientas se ponen al día, yo escribo en Markdown prácticamente en todas partes. Incluso donde nadie lo va a leer como tal.
Fuentes
- How Markdown took over the world, Anil Dash, enero de 2026
- Markdown, página oficial en Daring Fireball, John Gruber
- Standard Markdown becomes CommonMark, LWN.net, septiembre de 2014
- Text formatting in Notepad begins rolling out to Windows Insiders, Windows Insider Blog, mayo de 2025
- Notepad update begins rolling out to Windows Insiders, Windows Insider Blog, noviembre de 2025
- Import, export, and print notes on Mac, Apple Support
- How to import and export Markdown with Apple Notes in iOS 26, AppleInsider
- Import and export Markdown in Google Docs, Google Workspace Updates, julio de 2024
- OpenAI co-founds the Agentic AI Foundation, OpenAI, diciembre de 2025
- AGENTS.md Emerges as Open Standard for AI Coding Agents, InfoQ, agosto de 2025