From 640d99643ae62f64fd5855f1d5da06f9059d7c2b Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 14 May 2026 17:27:28 +0000
Subject: [PATCH 1/2] docs: document automatic markdown response for AI agent
user-agents
---
ai/markdown-export.mdx | 23 +++++++++++++++++++++++
1 file changed, 23 insertions(+)
diff --git a/ai/markdown-export.mdx b/ai/markdown-export.mdx
index 7d284da7b1..6847746d56 100644
--- a/ai/markdown-export.mdx
+++ b/ai/markdown-export.mdx
@@ -24,6 +24,29 @@ Send a request with `Accept: text/markdown` or `Accept: text/plain` to any page
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:
+
+- `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.
From 768642e5e42dc18f79e2d4c48fc82821d440998b Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 14 May 2026 17:28:58 +0000
Subject: [PATCH 2/2] docs: translate AI agent user-agent section to es and fr
---
es/ai/markdown-export.mdx | 25 +++++++++++++++++++++++++
fr/ai/markdown-export.mdx | 25 +++++++++++++++++++++++++
2 files changed, 50 insertions(+)
diff --git a/es/ai/markdown-export.mdx b/es/ai/markdown-export.mdx
index e067a1881d..86e26573c0 100644
--- a/es/ai/markdown-export.mdx
+++ b/es/ai/markdown-export.mdx
@@ -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
```
+
+ ## Detección automática para agentes de IA
+
+
+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.
+
## Contenido específico por audiencia
diff --git a/fr/ai/markdown-export.mdx b/fr/ai/markdown-export.mdx
index dfa4672b10..181c4425b5 100644
--- a/fr/ai/markdown-export.mdx
+++ b/fr/ai/markdown-export.mdx
@@ -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
```
+
+ ## Détection automatique des agents d'IA
+
+
+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.
+
## Contenu spécifique par audience