Qué es un archivo .md (y por qué la IA lo lee tan bien)

Al cerrar el sendero anterior ya dirigías a un agente: pedías, leías el permiso, guardabas la foto con git. Pero cada sesión arrancaba de cero, porque Claude no recuerda nada de la anterior. Este sendero arregla eso con unos pocos archivos de texto que hacen que tu carpeta se explique sola. Y empieza por el formato en que se escriben todos: el archivo .md.

Texto plano con jerarquía

Un archivo .md es texto plano con una convención mínima encima, Markdown: # abre un título, - un punto de lista y - [ ] una casilla. Así lo pinta un visor, y así está escrito por dentro:

# Barbería Don Julio

Notas de la página del negocio. Un solo archivo, **sin instalar nada**.

## Pendientes

- [x] elegir el nombre

- [ ] pedir la foto

- [ ] escribir `PROYECTO.md`

Por qué la IA lo lee tan bien

Eso de arriba es casi todo el formato: texto plano como el diario.txt del primer sendero, sin tipografías, sin menús, sin un programa especial para abrirlo. Y es el formato en que está escrita la documentación de casi todo el software del mundo: cada proyecto lleva su README.md, el archivo que se lee primero. Un modelo como Claude aprendió leyendo millones de esos README, así que Markdown es su idioma nativo para documentos: cuando ve ## entiende que empieza una sección, y cuando ve - [ ] entiende que hay una tarea pendiente. Un documento de Word lleva ese mismo texto envuelto en capas de formato que al agente no le sirven de nada. A ti también te conviene: un .md se lee en la terminal con cat, se abre con cualquier editor y, cuando llegue git, te va a mostrar los cambios línea por línea.

Dos vistas, un texto

A la práctica, en la carpeta de juego del sendero anterior: el archivo se escribe en el editor y se lee desde la terminal:

$ cd mi-jungla-ia$ code README.md# escribe unas líneas en el editor, guarda y vuelve a la terminal$ cat README.md# Mi jungla IACarpeta de práctica para dirigir a Claude Code.## Pendientes- [x] crear mi primer archivo con la IA- [ ] describir un proyecto de verdad

En el editor ves títulos grandes y una casilla marcada; en la terminal, el mismo texto con sus almohadillas y sus corchetes. Son dos vistas de un solo archivo, y la de la terminal es exactamente la que ve Claude. Ninguna es más «verdadera» que la otra: el archivo es el texto.

Ese es el idioma en que le vas a hablar al proyecto. En la próxima parada escribes el archivo más importante de todos, y lo escribes tú, no la IA.