Llevas semanas viendo la palabra. Que si el CLAUDE.md, que si el README, que si "ponlo en un archivo markdown". Suena a cosa de programador y por eso lo has estado saltando.
No lo es. Un archivo .md es texto. El mismo texto que escribirías en cualquier lado, con cinco símbolos que le indican qué es un título y qué es una lista. Se aprende en diez minutos y es la base de casi todo lo que hace un agente de IA bien montado.
Al final de esta guía hay una plantilla completa de "cómo trabajo" para que la llenes y se la des a tu IA. Ese solo archivo cambia la calidad de todo lo que te responde.
Qué es, en una frase
Markdown es una forma de darle formato a texto plano usando símbolos del teclado, y .md es la extensión de los archivos escritos así.
Piensa en la diferencia con Word. Un documento de Word guarda el texto y un montón de información sobre tipografías, márgenes, versiones y comentarios, todo comprimido en un formato que solo Word entiende bien. Un .md guarda el texto y ya. Lo abre cualquier programa, pesa nada, y dentro de veinte años se va a poder leer igual.
Por qué la IA trabaja mejor con ellos
Un modelo lee texto. Cuando le das un PDF o un Word, alguien tiene que convertirlo primero a texto, y en esa conversión se pierden cosas: el orden de las columnas, qué era encabezado y qué era nota al pie, dónde empezaba la tabla.
Con markdown no hay conversión. Los símbolos que le pones son los mismos que el modelo usa para entender la jerarquía: esto es un título, esto cuelga de aquel, esto es una lista de tres cosas del mismo tipo. Le estás dando el contenido y la estructura al mismo tiempo, sin ambigüedad.
Por eso las instrucciones de los agentes, las skills y los archivos de memoria se escriben en markdown. No es moda de programadores: es el formato con menos ruido entre lo que escribes y lo que el modelo entiende.
Los seis símbolos que necesitas
Son estos. No hay más que aprender para empezar:
# Título principal
## Título de sección
### Subtítulo
Un párrafo normal se escribe tal cual, sin ningún símbolo.
Para separar párrafos, deja una línea en blanco.
- Una lista
- Otro punto de la lista
- Y otro
1. Una lista numerada
2. Segundo paso
3. Tercer paso
**Esto queda en negrita** y *esto en cursiva*.
`Esto es un dato literal`, como un nombre de archivo.
[Texto del enlace](https://claude.com/)Eso es todo. El número de # indica el nivel: uno para el título del documento, dos para cada sección, tres para las subdivisiones. El guion hace listas. Los asteriscos dobles hacen negritas.
Si escribes el archivo y lo abres en un editor que entiende markdown, vas a ver los títulos grandes y las negritas puestas. Si lo abres en un editor que no lo entiende, vas a ver los símbolos crudos. Las dos cosas están bien: el archivo es el mismo.
Cómo creas uno, paso a paso
- En Mac: abre TextEdit, y en el menú Formato elige "Convertir en texto simple". Escribe. Guarda con el nombre que quieras, terminado en
.md. Si te pregunta si quieres usar esa extensión, di que sí. - En Windows: abre el Bloc de notas, escribe, y al guardar cambia el tipo de archivo a "Todos los archivos" y escribe el nombre completo con
.mdal final. Si guardas sin eso, Windows le pone.txt. - Más cómodo: instala un editor que lo entienda. Obsidian y Visual Studio Code son gratis y muestran el formato mientras escribes. Si vas a hacer esto seguido, vale los cinco minutos de instalación.
El error de principiante: creer que guardaste un .md cuando en realidad tienes un mi-archivo.md.txt. Pasa en Windows todo el tiempo porque el sistema esconde las extensiones. Actívalas en las opciones del explorador de archivos y revisa el nombre completo. Y nunca escribas estos archivos en Word: aunque le pongas la extensión, adentro no va texto plano.
La plantilla de "cómo trabajo"
Este es el archivo que le sirve a cualquiera, sin importar a qué te dediques. Es la descripción de tu contexto para que la IA deje de darte respuestas de manual.
Cópialo, guárdalo como como-trabajo.md y llena lo que está entre corchetes. Después súbelo a tu proyecto de Claude o pégalo en las instrucciones personalizadas.
# Cómo trabajo
## Quién soy
- Nombre: [tu nombre]
- Puesto: [tu puesto real, no el del organigrama]
- Empresa e industria: [qué hace la empresa y de qué tamaño es]
- Ciudad y zona horaria: [dónde]
- Idioma: [español de México / el que uses]
## De qué soy responsable
- [Resultado 1 por el que te evalúan]
- [Resultado 2]
- [Resultado 3]
## Con quién trabajo
- [Nombre o rol] — [qué le entrego o qué me entrega]
- [Nombre o rol] — [qué le entrego o qué me entrega]
## Herramientas que uso todos los días
- [Ej. Excel, HubSpot, Slack, Shopify]
## Cómo quiero que me respondas
- Tono: [directo / con matices / formal]
- Largo: [respuestas cortas / desarrolladas]
- Formato: [prosa / bullets / tablas]
- Si te falta un dato para responder bien, pregúntamelo.
No lo inventes.
- Si algo que te pido es mala idea, dímelo antes de hacerlo.
## Cosas que ya intenté y no funcionaron
- [Lo que no quieres que te vuelvan a proponer]
## Vocabulario de mi empresa
- [Término interno] = [qué significa]
- [Término interno] = [qué significa]
## Lo que nunca debes hacer
- [Ej. no escribir a clientes sin que yo lo revise]
- [Ej. no inventar cifras; si no las tienes, dilo]Llénalo con lo específico. "Trabajo en ventas" no sirve; "llevo 40 cuentas de distribuidores en el bajío y me evalúan por recompra, no por cuentas nuevas" cambia todas las respuestas que vas a recibir.
Dónde acaban usándose estos archivos
Una vez que sabes hacer uno, se te abren tres cosas. La primera son las instrucciones de proyecto: subes tu como-trabajo.md y ya no repites tu contexto en cada chat. La segunda es el CLAUDE.md, el archivo que define cómo se comporta la IA dentro de una carpeta o un proyecto de trabajo; está explicado a fondo en esta guía y hay una plantilla lista para copiar.
La tercera son las skills, que no son otra cosa que una carpeta con un archivo markdown adentro explicando cómo se hace un trabajo. Cuando alguien te diga "instálate esta skill", ahora ya sabes exactamente qué le estás dando de comer al modelo.
Qué hacer hoy
No te pongas a estudiar markdown. Se aprende usándolo y con los seis símbolos de arriba ya tienes el 95%.
Haz una sola cosa: llena la plantilla, guárdala, y úsala esta semana. La primera vez que te responda algo que ya toma en cuenta tu industria, tus herramientas y a quién le reportas, sin que se lo hayas explicado, vas a entender por qué todo el mundo insiste con los archivos .md.