De README.md a PROGRAM.md: Markdown ya es un lenguaje de programación

·

Durante 22 años, Markdown fue un formato de documentación. Escribías READMEs, publicaciones de blog y notas. Explicaba cosas a los humanos.

Luego algo cambió. En 2024, los asistentes de código de IA empezaron a leer .cursorrules y copilot-instructions.md. En 2025, AGENTS.md emergió como un estándar universal. A principios de 2026, Andrej Karpathy publicó autoresearch, donde toda la contribución humana es un archivo Markdown llamado program.md.

La evolución es clara:

EraArchivoAudienciaPropósito
2004-2023README.mdHumanosDocumentación
2024.cursorrulesHerramientas de código IAReglas de estilo de código
2025AGENTS.mdAgentes de código IAInstrucciones de proyecto
2026program.mdAgentes autónomosProgramas de investigación

Markdown ya no es solo documentación. Es un lenguaje de programación para la IA.

Las tres generaciones

Generación 1: Documentación (README.md)

El caso de uso original de Markdown. Escribes un README para ayudar a los humanos a entender tu proyecto. Es pasivo — está ahí hasta que un humano lo lee. Ninguna máquina actúa sobre él.

Generación 2: Configuración (AGENTS.md, CLAUDE.md)

Los asistentes de código de IA necesitan contexto del proyecto. AGENTS.md les indica los comandos de build, las convenciones de código y las decisiones arquitectónicas. CLAUDE.md personaliza el comportamiento de Claude Code. Estos archivos son activos — una IA los lee y cambia su comportamiento en consecuencia.

Pero el humano sigue escribiendo el código. El archivo Markdown solo ayuda a la IA a asistir mejor.

Generación 3: Programación (program.md)

Con autoresearch, el humano no escribe ningún código en absoluto. Toda la contribución es program.md — un archivo Markdown que define objetivos de investigación, restricciones y estrategia. El agente de IA lo lee y luego escribe, ejecuta e itera de forma autónoma sobre el código durante horas o días.

Esto es Markdown como lenguaje de programación. El resultado no es texto formateado — es código en ejecución, resultados experimentales y descubrimientos científicos.

¿Por qué Markdown?

¿Por qué todos los sistemas de IA convergieron en Markdown en lugar de, digamos, YAML, JSON o un DSL personalizado?

Está en los datos de entrenamiento. Los LLMs han visto miles de millones de archivos Markdown durante el entrenamiento. Entienden sus convenciones en profundidad — los encabezados indican jerarquía, los puntos indican listas, los bloques de código indican contenido ejecutable.

Es flexible. Markdown no impone un esquema rígido. Puedes escribir instrucciones de forma libre, tablas estructuradas, ejemplos de código y lenguaje natural en el mismo archivo. Esta flexibilidad coincide con cómo los humanos piensan en dirigir agentes de IA.

Es auditable. Puedes leer un program.md y entender exactamente qué se le está diciendo al agente que haga. Intenta eso con una configuración YAML de 500 líneas.

Es versionable. Cada cambio en las instrucciones de tu agente es un commit de git. Puedes comparar, revisar y revertir cambios de comportamiento de agentes igual que los cambios de código.

Lo que esto significa para ti

Si Markdown se está convirtiendo en un lenguaje de programación, entonces todos los que escriben Markdown se están convirtiendo en programadores de algún tipo. La habilidad no es la sintaxis — es la claridad de pensamiento y la precisión de las instrucciones.

Lo que importa ahora:

Aprender a escribir instrucciones Markdown precisas. Cuanto mejor sea tu AGENTS.md o program.md, mejor rendirá tu agente de IA. Esta es una nueva habilidad que combina conocimiento técnico con escritura clara.

Construir una biblioteca de referencia en Markdown. Cuando escribes instrucciones para agentes de IA, necesitas material de referencia: documentación, ejemplos, artículos, mejores prácticas. Tener este material en formato Markdown limpio lo hace inmediatamente utilizable.

Entender el ecosistema Markdown para IA. Conocer la diferencia entre AGENTS.md, CLAUDE.md, llms.txt y program.md. Cada uno sirve un propósito diferente en la creciente pila Markdown-for-AI.

Capturar conocimiento para instrucciones de agentes

Escribir buenas instrucciones para agentes de IA requiere conocimiento. Necesitas entender el dominio, las herramientas, las restricciones y los objetivos. Gran parte de este conocimiento vive en la web — en páginas de documentación, publicaciones de blog, artículos de investigación y tutoriales.

Save convierte cualquiera de estas fuentes web en Markdown limpio con un clic. Cuando estás elaborando un program.md o AGENTS.md, tener tu material de referencia ya en Markdown significa que puedes extraer, referenciar y construir sobre él de inmediato.

Los investigadores que escriben los mejores archivos program.md no parten de cero. Están construyendo sobre el conocimiento que han capturado y organizado en formato Markdown.


Save convierte cualquier página web en Markdown limpio — perfecto para construir la biblioteca de referencia que necesitas para escribir instrucciones efectivas para agentes de IA. Prueba Save gratis

## Continue reading

Jean-Sébastien Wallez

Written by

Jean-Sébastien Wallez

I've been making internet products for 10+ years. Built Save on weekends because I wanted my own reading library in clean markdown for Claude and Obsidian. Write here about web clipping, AI workflows, and the small things that make a personal knowledge base actually useful.

## try save

¿Listo para guardar de forma más inteligente?

Convierte cualquier página web a Markdown con un clic.

Agregar a Chrome 🐿️