llms.txt para sitios de documentación
Publicado:
Los sitios de documentación son el caso de uso ideal para llms.txt: la gente pregunta constantemente a las herramientas de IA "cómo hago X en tu producto", y un archivo bien organizado dirige a esos modelos directamente a las páginas adecuadas.
Por qué la documentación es la que más se beneficia
Tu documentación ya es la respuesta. llms.txt te permite entregar al modelo un índice limpio de ella —primeros pasos, guías, referencia de la API— en lugar de dejar que rastree la navegación, las interfaces de búsqueda y las páginas de marketing.
Genéralo a partir de tu estructura
La mayoría de los sitios de documentación ya tienen un sitemap.xml. Agrupa esas URL en unas pocas secciones con sentido en lugar de volcarlas en una lista plana:
# Acme Docs > Documentation for the Acme API: setup, guides, and the full endpoint reference. ## Getting started - [Quickstart](https://acme.com/docs/quickstart): First request in 5 minutes - [Authentication](https://acme.com/docs/auth): API keys and scopes ## Reference - [Endpoints](https://acme.com/docs/api): Every endpoint and parameter ## Optional - [Changelog](https://acme.com/docs/changelog): Release history
Enlaza las versiones en Markdown
Muchos frameworks de documentación (Docusaurus, MkDocs, Mintlify, GitBook y otros) pueden servir una versión en Markdown o en texto plano de cada página. Enlaza esas versiones —page.md— para que los modelos analicen contenido limpio en lugar de HTML renderizado con navegación y barras laterales.
Añade llms-full.txt para el contexto completo
Para conjuntos de documentación más grandes, publica un archivo complementario llms-full.txt con el texto completo incluido en línea, de modo que un agente pueda ingerirlo todo en una sola petición. Mantén llms.txt como el índice conciso.
Selecciona el contenido y luego valida
Tanto si escribes el archivo a mano como si lo generas con un plugin, revisa el resultado: los generadores automáticos tienden a incluir demasiado. Consulta los ejemplos de llms.txt para ver patrones y, a continuación, valida para confirmar la estructura y que cada enlace funciona correctamente.