# Export Markdown (/fr/ai/markdown-export)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1342 · updated: 2026-07-30 -->
Related: [Menu contextuel](/fr/ai/contextual-menu.md), [llms.txt](/fr/ai/llmstxt.md), [Serveur Admin Model Context Protocol (MCP)](/fr/ai/mintlify-mcp.md), [Serveur Search Model Context Protocol (MCP)](/fr/ai/model-context-protocol.md), [skill.md](/fr/ai/skillmd.md)

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 [#extension-durl-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 [#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
curl -L -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export
```

<div id="audience-specific-content">
  ## Contenu spécifique par audience [#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
<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 [#pages-de-référence-dapi]
</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
"markdown": {
  "schema": false
}
```

<div id="custom-agent-instructions">
  ## Instructions personnalisées pour les agents [#instructions-personnalisées-pour-les-agents]
</div>

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 :

```json title="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 :

```json title="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 :

```md title="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`](/fr/ai/llmstxt), 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](/fr/components/visibility).

<div id="authentication">
  ## Authentification [#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 [#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.