≡En resumen
- Los modelos de lenguaje han visto muchísimo Markdown al entrenarse, por eso lo leen y escriben con soltura.
- Transmite la misma estructura que HTML con muchos menos tokens.
- Los archivos de instrucciones de los agentes (CLAUDE.md, AGENTS.md, SKILL.md, DESIGN.md) están escritos en Markdown.
- Convertir PDF y documentos de Office a Markdown mejora las respuestas de un sistema RAG.
- Para separar partes de un prompt, Anthropic recomienda además usar etiquetas XML.
01 ¿Qué es Markdown y por qué importa en la IA?
Markdown es una forma de escribir texto con formato usando solo caracteres normales. Una línea que empieza por # es un título, un guion al principio crea una lista y un texto entre asteriscos dobles sale en negrita. John Gruber lo creó en 2004 para escribir para la web sin pelearse con el HTML.
Veinte años después se ha convertido en el idioma de trabajo de la IA. ChatGPT y Claude responden en Markdown, los agentes de programación leen sus instrucciones en archivos .md y la documentación técnica que alimenta a los modelos está llena de él. Saber escribir buen Markdown es, en la práctica, saber dar contexto bien ordenado a una IA.
02 Por qué los LLM trabajan mejor con Markdown
Menos tokens
Una tabla en HTML repite etiquetas en cada celda; en Markdown bastan unas barras. Menos ruido significa más espacio útil en el contexto.
Jerarquía clara
Los niveles de título indican qué depende de qué, y el modelo usa esa estructura para localizar información.
Código separado
Los bloques entre triples comillas invertidas marcan sin ambigüedad dónde empieza y acaba un fragmento de código o una salida.
Legible por personas
Se entiende sin renderizar, así que el mismo archivo sirve al equipo y al agente.
Amigo de Git
Es texto plano: los cambios se revisan línea a línea y quedan versionados con el código.
03 Sintaxis esencial de Markdown para prompts y documentos
| Elemento | Cómo se escribe | Para qué sirve con IA |
|---|---|---|
| Títulos | # Título, ## Subtítulo | Dividir instrucciones o documentos en secciones localizables |
| Listas | - elemento o 1. paso | Requisitos, reglas y pasos en orden |
| Negrita | **importante** | Señalar la regla que no se puede saltar (con moderación) |
| Código en línea | `comando` | Nombres de archivos, comandos o variables exactos |
| Bloque de código | ``` al principio y al final | Código, JSON de ejemplo o salidas que deben copiarse literalmente |
| Tablas | | col | col | con fila de guiones | Comparativas y datos tabulares que el modelo debe leer por filas |
| Enlaces | [texto](url) | Referencias a otros documentos o fuentes |
04 Archivos .md que usan Claude y otros agentes
Buena parte de la configuración de los agentes de IA son simples archivos Markdown con un nombre convenido. El más conocido es CLAUDE.md, que Claude Code carga al empezar cada sesión.
| Archivo | Función |
|---|---|
| CLAUDE.md | Instrucciones persistentes del proyecto o del usuario para Claude Code |
| AGENTS.md | Instrucciones de proyecto en un formato compartido por varios agentes de código |
| SKILL.md | Define una skill: cuándo usarla y qué pasos seguir, con un encabezado YAML |
| DESIGN.md | Describe el sistema de diseño visual para que el agente lo respete |
| llms.txt | Propuesta para que una web ofrezca a los modelos un resumen con enlaces a su contenido clave |
| README.md | La documentación de entrada de un repositorio, que los agentes leen para orientarse |
05 Cómo convertir PDF, Word y webs a Markdown
-
1
Elige el conversor
MarkItDown, de Microsoft, convierte PDF, Word, Excel, PowerPoint y HTML a Markdown; Pandoc es la navaja suiza clásica para documentos.
-
2
Convierte y revisa las tablas
Las tablas complejas y los PDF escaneados son lo que peor se convierte: compruébalos a mano o usa reconocimiento de texto.
-
3
Limpia el ruido
Quita cabeceras repetidas, números de página, menús y avisos legales que no aportan a la tarea.
-
4
Estructura con títulos
Asegúrate de que cada capítulo o apartado tiene su título; es lo que permitirá trocear el documento con sentido.
-
5
Trocea para RAG
Si vas a montar una búsqueda semántica, divide por secciones en lugar de por número fijo de caracteres.
Ese troceado por secciones es la base de un buen sistema de recuperación aumentada (RAG): cada fragmento conserva su título y el modelo recibe piezas con sentido completo.
06 Markdown o etiquetas XML en los prompts
La guía de prompts de Anthropic recomienda envolver las partes de un prompt en etiquetas XML, como <contrato> o <instrucciones>, para que Claude no confunda los datos con las órdenes. No compite con Markdown: lo habitual es combinar ambos.
<instrucciones>## TareaResume el contrato para el equipo comercial.## Reglas- Máximo 10 líneas.- Si falta un dato, escribe «no consta».</instrucciones><contrato>…texto del contrato en Markdown…</contrato>
Las etiquetas separan qué es orden y qué es material; el Markdown ordena cada bloque por dentro.
07 Markdown, llms.txt y visibilidad en buscadores de IA
El archivo llms.txt lo propuso Jeremy Howard en septiembre de 2024: un Markdown en la raíz de la web que resume el sitio y enlaza sus páginas clave, pensado para que los modelos lo lean sin pelearse con menús y scripts. Es una propuesta, no un estándar que todos los buscadores usen, así que no sustituye a un contenido bien estructurado.
- ✓Títulos que responden preguntas concretas y un párrafo directo debajo de cada uno.
- ✓Listas y tablas reales en el HTML, no imágenes con texto.
- ✓Datos verificables con fecha y fuente.
- ✓Una versión limpia y legible de tus páginas clave, sea con llms.txt o con un HTML sencillo.
Esa misma claridad que ayuda a un agente ayuda a que te citen: es la base del SEO para IA y de una buena redacción de contenidos SEO. En nuestro listado de herramientas para trabajar con Claude encontrarás conversores y utilidades para preparar documentos.
Preguntas frecuentes sobre Markdown para IA
Porque los modelos aprendieron con enormes cantidades de texto en Markdown y las interfaces de chat lo muestran con formato. Es una forma barata y clara de dar estructura a una respuesta.
Claude puede leer PDF directamente, pero un Markdown limpio suele ocupar menos tokens y evita errores de lectura en tablas y columnas. Para documentos que vas a usar muchas veces, merece la pena convertirlos.
Es una propuesta de 2024 para que las webs publiquen un archivo Markdown en su raíz con un resumen y enlaces a su contenido más importante, pensado para que lo lean los modelos de IA.
Ambos. Anthropic recomienda etiquetas XML para separar instrucciones, datos y ejemplos, y dentro de cada bloque Markdown funciona muy bien para títulos y listas.
MarkItDown, de Microsoft, es de código abierto y convierte PDF, Word, Excel, PowerPoint y HTML. Pandoc es otra opción veterana muy completa.
No, pero conocer cuatro símbolos (títulos, listas, código y tablas) te permite escribir prompts y archivos como CLAUDE.md mucho más claros.
Es un archivo de texto plano escrito en Markdown. Se abre con cualquier editor de texto y plataformas como GitHub o los chats de IA lo muestran con formato: títulos, listas, tablas y código.
Pídelo de forma explícita, por ejemplo «responde en párrafos de texto plano, sin títulos ni viñetas», y si vas a mostrar la respuesta en tu propia aplicación indica el formato exacto que esperas.
Fuentes consultadas
Sobre el autor
Germán Gutiérrez
Development Manager en appyweb
Dirige el equipo de desarrollo de appyweb: aplicaciones web y móviles, SaaS, integraciones y arquitectura de software.
Ver perfil en LinkedIn ↗