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. Si llegaste buscando qué es un archivo md, esto es exactamente eso: los dos nombres son el mismo archivo, con punto y sin punto.
Texto plano con jerarquía
A un archivo .md también se le dice fichero md o documento md, según de dónde seas. Es el mismo texto plano con tres reglas 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`Barbería Don Julio
Notas de la página del negocio. Un solo archivo, sin instalar nada.
Pendientes
- elegir el nombre
- pedir la foto
- escribir
PROYECTO.md
Por qué la IA lee tan bien un archivo md
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.
Con qué se abre un archivo md
Con cualquier editor de texto que ya tengas, porque es texto y nada más. Un editor de código además te lo pinta con los títulos grandes y las casillas marcadas, aunque el archivo por dentro siga siendo el mismo. Y si se lo tienes que mandar a alguien que no sabe qué es esto, se convierte a PDF o a Word en un paso. Lo que no hace falta en ningún caso es instalar un programa para poder leerlo.
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:
- Abrir el editor → Archivo → Guardar como… → elegir la carpeta
$ 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 verdadEn 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.
El claro de Markdown
El sendero sigue por su camino, pero aquí al lado hay un claro: cinco respuestas sueltas sobre Markdown, sin orden ni requisitos. Entra si te quedaste con una pregunta y vuelve cuando quieras.
Preguntas frecuentes sobre los archivos md
Un archivo de texto plano con tres reglas de formato encima: la almohadilla para los títulos, el guion para las listas y el guion con corchetes para las casillas. El formato se llama Markdown. Lo abre cualquier editor de texto, sin programas especiales.
Es la abreviatura de Markdown, el nombre del formato. Se escribe como extensión del archivo: notas.md, README.md. También verás .markdown, que es lo mismo y casi nadie usa.
Sí, es la misma cosa con dos nombres: fichero es la palabra habitual en España y archivo la de América. También verás documento md. Los tres nombran el mismo archivo de texto.
Con cualquier editor de texto que ya tengas: el Bloc de notas en Windows, TextEdit en Mac. Verás el texto con sus almohadillas y sus guiones, que es exactamente lo que hay dentro. Un editor de código te lo pinta con los títulos grandes, pero el archivo es el mismo.
Abres un editor de texto, escribes, y lo guardas con la extensión .md en lugar de .txt. Ese cambio de tres letras es todo. Cuidado en Windows: el Explorador viene de fábrica escondiendo las extensiones, así que conviene comprobar el nombre completo desde la terminal.
Sí, y a Word sale con un solo comando. Lo que se pierde al convertir es la parte que hacía cómodo el Markdown: el archivo deja de ser texto plano y vuelve a necesitar un programa para abrirse.
