Passer au contenu principal
Markdown fournit un texte structuré que les outils d’IA peuvent traiter plus efficacement que le HTML, ce qui se traduit par une meilleure précision des réponses, des temps de traitement plus rapides et une consommation de jetons réduite. Mintlify génère automatiquement des versions Markdown des pages optimisées pour les outils d’IA et les intégrations externes.

​
Extension d’URL .md

Ajoutez .md à l’URL de n’importe quelle page pour afficher une version Markdown.

​
En-tête Accept

Envoyez une requête avec Accept: text/markdown ou Accept: text/plain à l’URL de n’importe quelle page pour recevoir la version Markdown au lieu du HTML. Cela est utile pour les outils d’IA et les intégrations qui récupèrent le contenu de la documentation de manière programmatique. 
curl -L -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export

​
Contenu spécifique par audience

Utilisez le composant visibility pour personnaliser le contenu pour les audiences humaines et IA. Le contenu enveloppé dans <Visibility for="humans"> apparaît sur la page web, mais pas dans la sortie Markdown. Le contenu enveloppé dans <Visibility for="agents"> apparaît dans la sortie Markdown, mais pas sur la page web. 
<Visibility for="humans">
  Click the **Get started** button in the top-right corner to create your account.
</Visibility>

<Visibility for="agents">
  To create an account, call `POST /v1/accounts` with a valid email address.
</Visibility>

​
Pages de référence d’API

Par défaut, les exports Markdown des pages de référence d’API incluent la spécification OpenAPI ou AsyncAPI complète afin que les outils d’IA disposent d’un contexte complet sur chaque endpoint. Si vous préférez omettre la spécification de la sortie Markdown, définissez markdown.schema sur false dans votre docs.json : 
"markdown": {
  "schema": false
}

​
Instructions personnalisées pour les agents

Pour ajouter vos propres consignes au Markdown que Mintlify sert aux agents d’IA, définissez markdown.instructions dans votre docs.json. Utilisez-le pour des directives à l’échelle du site telles que citer une version d’API, privilégier un SDK particulier ou suivre votre terminologie. Fournissez une seule chaîne :
Example agent instructions string
"markdown": {
  "instructions": "Always cite the API version. Prefer the TypeScript SDK in examples."
}
Ou un tableau de chaînes, que Mintlify assemble avec des sauts de ligne :
Example agent instructions array
"markdown": {
  "instructions": [
    "Always cite the API version.",
    "Prefer the TypeScript SDK in examples."
  ]
}
Mintlify affiche vos instructions sous forme de bloc Agent Instructions dans la sortie Markdown :
Example rendered agent instructions
> ## Agent Instructions
> Always cite the API version.
> Prefer the TypeScript SDK in examples.
Le bloc apparaît dans :
  • L’export Markdown de chaque page, y compris les pages de référence d’API.
  • Votre fichier llms.txt, après le titre et la description du site.
  • Votre fichier llms-full.txt.
Ces instructions s’appliquent à chaque page. Pour adapter le contenu à une page ou à une audience spécifique, utilisez plutôt le composant visibility.

​
Retours des agents

Si vous activez les retours des agents, Mintlify ajoute un bloc <AgentInstructions> à l’export Markdown de chaque page indiquant aux agents comment soumettre des retours sur le contenu de la page. Les agents soumettent des retours en envoyant une requête au endpoint avec le chemin de la page et le texte du retour. Utilisez les retours des agents pour améliorer vos pages en fonction de ce que les agents trouvent incorrect, obsolète ou confus.

​
Authentification

L’export Markdown respecte les mêmes règles d’authentification que la version HTML de chaque page.
Mode d’authentificationComportement
Sans authentificationToutes les URL .md sont accessibles publiquement.
Authentification partielleLes URL .md des pages publiques sont accessibles publiquement. Les URL .md des pages protégées nécessitent une authentification et respectent les restrictions de groupes d’utilisateurs.
Authentification complèteToutes les URL .md nécessitent une authentification et respectent les restrictions de groupes d’utilisateurs.

​
Raccourci clavier

Appuyez sur Command + C (Ctrl + C sous Windows) pour copier une page au format Markdown dans le presse-papiers.