Docs prêtes pour les LLM

Rendez votre documentation publiée plus facile à découvrir, lire et utiliser pour les outils d’IA

GitBook publie automatiquement des formats adaptés à l’IA pour votre site de documentation.

Ils aident les grands modèles de langage (LLM), les agents de codage et les systèmes de recherche IA. Ces outils peuvent découvrir et récupérer une documentation précise sans analyser le HTML.

Pages Markdown

Ajoutez .md à toute URL de page publiée pour afficher son Markdown. Le Markdown fournit aux outils d’IA un contenu structuré sans le HTML environnant.

Consultez le fichier .md de cette page

llms.txt

llms.txt est une norme proposée pour le contenu web adapté aux LLM. Ajoutez /llms.txt à l’URL racine de votre site de documentation.

Il répertorie chaque page publiée avec une version Markdown. Les outils d’IA peuvent utiliser cet index pour découvrir votre documentation.

Consultez le /llms.txt pour la documentation GitBook

llms-full.txt

Ajoutez /llms-full.txt à l’URL racine de votre site de documentation. Ce fichier inclut l’intégralité de votre documentation en un seul endroit.

Les pages masquées sont incluses dans llms-full.txt. Le fait de masquer une page la supprime uniquement de la table des matières publiée.

Consultez le fichier /llms-full.txt pour la documentation GitBook

Serveur MCP pour la documentation publiée

GitBook expose un serveur Model Context Protocol (MCP) pour chaque site de documentation publié. Les outils compatibles peuvent découvrir et récupérer votre documentation sous forme de ressources structurées.

Les pages masquées restent accessibles via le serveur MCP du site. Le fait de masquer une page la supprime uniquement de la table des matières publiée.

Ajoutez /~gitbook/mcp à l’URL racine de votre site de documentation. Par exemple, le serveur MCP de GitBook est https://gitbook.com/docs/~gitbook/mcp.

L’ouverture de cette URL dans un navigateur renvoie une erreur. Utilisez un outil capable d’effectuer des requêtes HTTP.

En savoir plus dans Serveurs MCP pour la documentation publiée.

Optimiser votre documentation pour l’IA

GitBook gère la couche de diffusion. Votre rédaction façonne la qualité des réponses de l’IA.

Rédigez un contenu que les outils d’IA peuvent interpréter de manière fiable :

• Attribuez un objectif clair à chaque page.
• Utilisez des titres descriptifs et des sections courtes.
• Indiquez directement les contraintes, les valeurs par défaut et les exigences.
• Incluez des exemples concrets et des valeurs exactes.
• Mettez à jour le contenu lorsque votre produit change.

Ces pratiques améliorent la recherche, réduisent l’ambiguïté et aident les utilisateurs à trouver des réponses.

Maintenir les traductions synchronisées

Si vous publiez dans plusieurs langues, veillez à ce que chaque traduction reste alignée sur sa source.

Traductions vous permettent de localiser le contenu avec GitBook Agent. Lorsque le contenu source change, GitBook peut maintenir les versions traduites alignées.

Mesurer le trafic IA

Utilisez Analyse du site pour suivre le trafic provenant des LLM et des clients MCP.