> ## Documentation Index
> Fetch the complete documentation index at: https://adminroletesting-justin-client-exports.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Export Markdown

> Exportez des versions Markdown propres de vos pages de documentation pour les outils d'IA, les intégrations LLM et les workflows de traitement automatisé.

export const PreviewButton = ({children, href}) => {
  return <a href={href} className="text-sm font-medium text-white dark:!text-zinc-950 bg-zinc-900 hover:bg-zinc-700 dark:bg-zinc-100 hover:dark:bg-zinc-300 rounded-full px-3.5 py-1.5 not-prose">
        {children}
      </a>;
};

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.

<div id="md-url-extension">
  ## Extension d'URL .md
</div>

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

<PreviewButton href="https://mintlify.com/docs/ai/markdown-export.md">Ouvrir cette page au format Markdown</PreviewButton>

<div id="accept-header">
  ## En-tête Accept
</div>

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.

```bash theme={null}
curl -L -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export
```

<div id="audience-specific-content">
  ## Contenu spécifique par audience
</div>

Utilisez le composant [visibility](/fr/components/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.

```mdx theme={null}
<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>
```

<div id="api-reference-pages">
  ## Pages de référence d'API
</div>

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` :

```json theme={null}
"markdown": {
  "schema": false
}
```

<div id="agent-feedback">
  ## Retours des agents
</div>

Si vous activez les [retours des agents](/fr/optimize/feedback#agent-feedback), 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.

<div id="authentication">
  ## Authentification
</div>

L'export Markdown respecte les mêmes règles d'authentification que la version HTML de chaque page.

| Mode d'authentification    | Comportement                                                                                                                                                                                  |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Sans authentification      | Toutes les URL `.md` sont accessibles publiquement.                                                                                                                                           |
| Authentification partielle | Les 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ète  | Toutes les URL `.md` nécessitent une authentification et respectent les restrictions de groupes d'utilisateurs.                                                                               |

<div id="keyboard-shortcut">
  ## Raccourci clavier
</div>

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