Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions ai/markdown-export.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,29 @@
curl -L -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export
```

## Automatic detection for AI agents

Mintlify automatically returns the Markdown version of a page when the request comes from a known AI agent, even if the agent does not send an `Accept: text/markdown` header. This ensures agents receive the most efficient content format without any extra configuration.

Detection is based on the `User-Agent` header. The following agents are currently recognized:

Check warning on line 31 in ai/markdown-export.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/markdown-export.mdx#L31

In general, use active voice instead of passive voice ('is based').

- `Claude-User` (Anthropic Claude Code and browsing)
- `ChatGPT-User` (OpenAI ChatGPT browsing)
- `OAI-SearchBot` (OpenAI search)
- `PerplexityBot` and `Perplexity-User` (Perplexity AI)
- `Google-Agent` (Google Project Mariner)
- `MistralAI-User` (Mistral Le Chat)
- `DuckAssistBot` (DuckDuckGo AI Answers)
- `cohere-ai` (Cohere AI assistant)

For example, a request with a recognized agent user-agent receives Markdown:

```bash
curl -L -H "User-Agent: Claude-User/1.0" https://mintlify.com/docs/ai/markdown-export
```

Human visitors using standard browsers continue to receive the HTML version of the page.

## Audience-specific content

Use the [visibility](/components/visibility) component to customize content for each human and AI audiences.
Expand Down
25 changes: 25 additions & 0 deletions es/ai/markdown-export.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,31 @@ Envía una solicitud con `Accept: text/markdown` o `Accept: text/plain` a la URL
curl -L -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export
```

<div id="automatic-detection-for-ai-agents">
## Detección automática para agentes de IA
</div>

Mintlify devuelve automáticamente la versión en Markdown de una página cuando la solicitud proviene de un agente de IA conocido, incluso si el agente no envía un encabezado `Accept: text/markdown`. Esto garantiza que los agentes reciban el formato de contenido más eficiente sin configuración adicional.

La detección se basa en el encabezado `User-Agent`. Actualmente se reconocen los siguientes agentes:

- `Claude-User` (Anthropic Claude Code y navegación)
- `ChatGPT-User` (navegación de ChatGPT de OpenAI)
- `OAI-SearchBot` (búsqueda de OpenAI)
- `PerplexityBot` y `Perplexity-User` (Perplexity AI)
- `Google-Agent` (Google Project Mariner)
- `MistralAI-User` (Mistral Le Chat)
- `DuckAssistBot` (DuckDuckGo AI Answers)
- `cohere-ai` (asistente de IA de Cohere)

Por ejemplo, una solicitud con un user-agent de un agente reconocido recibe Markdown:

```bash
curl -L -H "User-Agent: Claude-User/1.0" https://mintlify.com/docs/ai/markdown-export
```

Los visitantes humanos que usan navegadores estándar siguen recibiendo la versión HTML de la página.

<div id="audience-specific-content">
## Contenido específico por audiencia
</div>
Expand Down
25 changes: 25 additions & 0 deletions fr/ai/markdown-export.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,31 @@ Envoyez une requête avec `Accept: text/markdown` ou `Accept: text/plain` à l'U
curl -L -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export
```

<div id="automatic-detection-for-ai-agents">
## Détection automatique des agents d'IA
</div>

Mintlify renvoie automatiquement la version Markdown d'une page lorsque la requête provient d'un agent d'IA connu, même si l'agent n'envoie pas d'en-tête `Accept: text/markdown`. Cela garantit que les agents reçoivent le format de contenu le plus efficace sans configuration supplémentaire.

La détection repose sur l'en-tête `User-Agent`. Les agents suivants sont actuellement reconnus :

- `Claude-User` (Anthropic Claude Code et navigation)
- `ChatGPT-User` (navigation ChatGPT d'OpenAI)
- `OAI-SearchBot` (recherche OpenAI)
- `PerplexityBot` et `Perplexity-User` (Perplexity AI)
- `Google-Agent` (Google Project Mariner)
- `MistralAI-User` (Mistral Le Chat)
- `DuckAssistBot` (DuckDuckGo AI Answers)
- `cohere-ai` (assistant IA de Cohere)

Par exemple, une requête avec un user-agent reconnu reçoit du Markdown :

```bash
curl -L -H "User-Agent: Claude-User/1.0" https://mintlify.com/docs/ai/markdown-export
```

Les visiteurs humains utilisant des navigateurs standards continuent de recevoir la version HTML de la page.

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