From 3a17d34b804da4c87a745c67b82867af50c3eff8 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Sun, 6 Sep 2026 06:28:09 +0000
Subject: [PATCH] docs: document Markdown 404 recovery guidance and discovery
headers
---
ai/llmstxt.mdx | 2 +-
ai/markdown-export.mdx | 21 +++++++++++++++++++++
es/ai/llmstxt.mdx | 2 +-
es/ai/markdown-export.mdx | 23 +++++++++++++++++++++++
fr/ai/llmstxt.mdx | 2 +-
fr/ai/markdown-export.mdx | 23 +++++++++++++++++++++++
zh/ai/llmstxt.mdx | 2 +-
zh/ai/markdown-export.mdx | 23 +++++++++++++++++++++++
8 files changed, 94 insertions(+), 4 deletions(-)
diff --git a/ai/llmstxt.mdx b/ai/llmstxt.mdx
index 9b18c523ab..d964b4cce4 100644
--- a/ai/llmstxt.mdx
+++ b/ai/llmstxt.mdx
@@ -24,7 +24,7 @@ View your `llms.txt` by appending `/llms.txt` to your documentation site's URL.
Open the llms.txt for this site.
-Mintlify adds HTTP headers to every page response so AI tools can discover your `llms.txt` files and other agent resources without prior knowledge of their location:
+Mintlify adds HTTP headers to every response, including [Markdown responses](/ai/markdown-export) and 404 pages, so AI tools can discover your `llms.txt` files and other agent resources without prior knowledge of their location:
- `Link`: Follows the standard HTTP `Link` header format for resource discovery. Advertises `llms.txt`, `llms-full.txt`, your API catalog, [MCP server card](/ai/model-context-protocol#discovery-endpoint), [agent card](/ai/skillmd#agent-card), and [agent skills index](/ai/skillmd#skills-discovery-endpoints).
- `X-Llms-Txt`: A convenience header for tools that check for `llms.txt` support.
diff --git a/ai/markdown-export.mdx b/ai/markdown-export.mdx
index 1a3e242b1f..9b4e2dc916 100644
--- a/ai/markdown-export.mdx
+++ b/ai/markdown-export.mdx
@@ -24,6 +24,27 @@ 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
```
+## Missing pages
+
+If you request a page that doesn't exist as Markdown, Mintlify returns a 404 status with a Markdown body that helps AI tools recover. The response links to your documentation index (`llms.txt`), your full documentation file (`llms-full.txt`), and up to three related pages based on the requested path.
+
+```md Example Markdown 404 response
+> ## Documentation Index
+> Fetch the documentation index at: https://example.com/docs/llms.txt
+> Use this file to discover all available pages before exploring further.
+> For broader context, fetch the full documentation at: https://example.com/docs/llms-full.txt (large file).
+
+# Page Not Found
+
+The requested page could not be found.
+
+## Related topics
+
+- [Getting started](https://example.com/docs/getting-started.md)
+```
+
+Related page suggestions come from the same search that powers your site's [404 page](/customize/custom-404-page). Sites that use [authentication](/deploy/authentication-setup) omit suggestions and return only the documentation links.
+
## Audience-specific content
Use the [visibility](/components/visibility) component to customize content for human and AI audiences.
diff --git a/es/ai/llmstxt.mdx b/es/ai/llmstxt.mdx
index 9edfbea429..2b72e0e065 100644
--- a/es/ai/llmstxt.mdx
+++ b/es/ai/llmstxt.mdx
@@ -24,7 +24,7 @@ Consulta tu `llms.txt` añadiendo `/llms.txt` a la URL de tu sitio de documentac
Abrir el llms.txt de este sitio.
-Mintlify añade encabezados HTTP a cada respuesta de página para que las herramientas de IA puedan descubrir tus archivos `llms.txt` y otros recursos para agentes sin conocer previamente su ubicación:
+Mintlify añade encabezados HTTP a cada respuesta, incluidas las [respuestas Markdown](/es/ai/markdown-export) y las páginas 404, para que las herramientas de IA puedan descubrir tus archivos `llms.txt` y otros recursos para agentes sin conocer previamente su ubicación:
- `Link`: Sigue el formato estándar del encabezado HTTP `Link` para el descubrimiento de recursos. Anuncia `llms.txt`, `llms-full.txt`, tu catálogo de API, [tarjeta del servidor MCP](/es/ai/model-context-protocol#discovery-endpoint), [tarjeta del agente](/es/ai/skillmd#agent-card) e [índice de skills del agente](/es/ai/skillmd#skills-discovery-endpoints).
- `X-Llms-Txt`: Un encabezado de conveniencia para herramientas que verifican la compatibilidad con `llms.txt`.
diff --git a/es/ai/markdown-export.mdx b/es/ai/markdown-export.mdx
index fe6d2798e6..2292267a29 100644
--- a/es/ai/markdown-export.mdx
+++ b/es/ai/markdown-export.mdx
@@ -29,6 +29,29 @@ 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
```
+
+ ## Páginas inexistentes
+
+
+Si solicitas en Markdown una página que no existe, Mintlify devuelve un estado 404 con un cuerpo Markdown que ayuda a las herramientas de IA a recuperarse. La respuesta enlaza al índice de tu documentación (`llms.txt`), a tu archivo de documentación completa (`llms-full.txt`) y hasta a tres páginas relacionadas según la ruta solicitada.
+
+```md Example Markdown 404 response
+> ## Documentation Index
+> Fetch the documentation index at: https://example.com/docs/llms.txt
+> Use this file to discover all available pages before exploring further.
+> For broader context, fetch the full documentation at: https://example.com/docs/llms-full.txt (large file).
+
+# Page Not Found
+
+The requested page could not be found.
+
+## Related topics
+
+- [Getting started](https://example.com/docs/getting-started.md)
+```
+
+Las sugerencias de páginas relacionadas provienen de la misma búsqueda que impulsa la [página 404](/es/customize/custom-404-page) de tu sitio. Los sitios que usan [autenticación](/es/deploy/authentication-setup) omiten las sugerencias y devuelven solo los enlaces de documentación.
+
## Contenido específico por audiencia
diff --git a/fr/ai/llmstxt.mdx b/fr/ai/llmstxt.mdx
index 45f0a3f9ca..41bbabe4d5 100644
--- a/fr/ai/llmstxt.mdx
+++ b/fr/ai/llmstxt.mdx
@@ -24,7 +24,7 @@ Affichez votre `llms.txt` en ajoutant `/llms.txt` à l'URL de votre site de docu
Ouvrir le llms.txt de ce site.
-Mintlify ajoute des en-têtes HTTP à chaque réponse de page afin que les outils d'IA puissent découvrir vos fichiers `llms.txt` et autres ressources d'agent sans connaître au préalable leur emplacement :
+Mintlify ajoute des en-têtes HTTP à chaque réponse, y compris les [réponses Markdown](/fr/ai/markdown-export) et les pages 404, afin que les outils d'IA puissent découvrir vos fichiers `llms.txt` et autres ressources d'agent sans connaître au préalable leur emplacement :
- `Link` : Suit le format standard de l'en-tête HTTP `Link` pour la découverte de ressources. Annonce `llms.txt`, `llms-full.txt`, votre catalogue d'API, la [carte du serveur MCP](/fr/ai/model-context-protocol#discovery-endpoint), l'[agent card](/fr/ai/skillmd#agent-card) et l'[index des agent skills](/fr/ai/skillmd#skills-discovery-endpoints).
- `X-Llms-Txt` : Un en-tête pratique pour les outils qui vérifient la prise en charge de `llms.txt`.
diff --git a/fr/ai/markdown-export.mdx b/fr/ai/markdown-export.mdx
index a9a75e3859..8b678c7527 100644
--- a/fr/ai/markdown-export.mdx
+++ b/fr/ai/markdown-export.mdx
@@ -29,6 +29,29 @@ 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
```
+
+ ## Pages introuvables
+
+
+Si vous demandez en Markdown une page qui n'existe pas, Mintlify renvoie un statut 404 avec un corps Markdown qui aide les outils d'IA à se rétablir. La réponse renvoie vers l'index de votre documentation (`llms.txt`), votre fichier de documentation complète (`llms-full.txt`) et jusqu'à trois pages associées selon le chemin demandé.
+
+```md Example Markdown 404 response
+> ## Documentation Index
+> Fetch the documentation index at: https://example.com/docs/llms.txt
+> Use this file to discover all available pages before exploring further.
+> For broader context, fetch the full documentation at: https://example.com/docs/llms-full.txt (large file).
+
+# Page Not Found
+
+The requested page could not be found.
+
+## Related topics
+
+- [Getting started](https://example.com/docs/getting-started.md)
+```
+
+Les suggestions de pages associées proviennent de la même recherche que celle de la [page 404](/fr/customize/custom-404-page) de votre site. Les sites qui utilisent l'[authentification](/fr/deploy/authentication-setup) omettent les suggestions et ne renvoient que les liens de documentation.
+
## Contenu spécifique par audience
diff --git a/zh/ai/llmstxt.mdx b/zh/ai/llmstxt.mdx
index 846f19b670..ab7bb3f683 100644
--- a/zh/ai/llmstxt.mdx
+++ b/zh/ai/llmstxt.mdx
@@ -24,7 +24,7 @@ Mintlify 会在项目根目录自动托管一个 `llms.txt` 文件，列出文
打开此站点的 llms.txt。
-Mintlify 会在每个页面的响应中添加 HTTP 标头，以便 AI 工具无需事先知道位置即可发现你的 `llms.txt` 文件以及其他代理资源：
+Mintlify 会在每个响应中添加 HTTP 标头，包括 [Markdown 响应](/zh/ai/markdown-export)和 404 页面，以便 AI 工具无需事先知道位置即可发现你的 `llms.txt` 文件以及其他代理资源：
- `Link`：遵循标准 HTTP `Link` 标头格式，用于资源发现。会公布 `llms.txt`、`llms-full.txt`、你的 API 目录、[MCP 服务器卡片](/zh/ai/model-context-protocol#discovery-endpoint)、[代理卡片](/zh/ai/skillmd#agent-card)以及[代理技能索引](/zh/ai/skillmd#skills-discovery-endpoints)。
- `X-Llms-Txt`：一个便捷标头，供检查 `llms.txt` 支持情况的工具使用。
diff --git a/zh/ai/markdown-export.mdx b/zh/ai/markdown-export.mdx
index 9a50c793f3..68222a8c5e 100644
--- a/zh/ai/markdown-export.mdx
+++ b/zh/ai/markdown-export.mdx
@@ -29,6 +29,29 @@ Mintlify 会自动生成针对 AI 工具和外部 integrations 优化的页面 M
curl -L -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export
```
+
+ ## 不存在的页面
+
+
+如果你以 Markdown 形式请求一个不存在的页面，Mintlify 会返回 404 状态码以及一个帮助 AI 工具恢复的 Markdown 响应体。该响应包含指向文档索引（`llms.txt`）、完整文档文件（`llms-full.txt`）的链接，以及根据请求路径推荐的最多三个相关页面。
+
+```md Example Markdown 404 response
+> ## Documentation Index
+> Fetch the documentation index at: https://example.com/docs/llms.txt
+> Use this file to discover all available pages before exploring further.
+> For broader context, fetch the full documentation at: https://example.com/docs/llms-full.txt (large file).
+
+# Page Not Found
+
+The requested page could not be found.
+
+## Related topics
+
+- [Getting started](https://example.com/docs/getting-started.md)
+```
+
+相关页面建议来自为你站点 [404 页面](/zh/customize/custom-404-page)提供支持的同一搜索。使用[身份验证](/zh/deploy/authentication-setup)的站点会省略建议，仅返回文档链接。
+
## 面向特定受众的内容