Skip to content

docs: document automatic markdown for AI agent user-agents#5807

Open
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/44bd797b
Open

docs: document automatic markdown for AI agent user-agents#5807
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/44bd797b

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 14, 2026

Summary

Documents a new platform behavior: Mintlify now automatically serves the Markdown version of a page when the request's User-Agent matches a known AI agent, even when the agent doesn't send an Accept: text/markdown header.

Changes

  • Added an "Automatic detection for AI agents" section to ai/markdown-export.mdx
  • Listed the AI agents currently recognized by user-agent (Claude, ChatGPT, Perplexity, Google Project Mariner, Mistral, DuckAssist, Cohere, OAI-SearchBot)
  • Included a curl example demonstrating the behavior
  • Clarified that standard browser visitors continue to receive HTML

Context

Follows the upstream change that adds a user-agent check so AI agents reliably receive Markdown without needing to set request headers.


Note

Low Risk
Low risk: documentation-only changes that describe existing behavior and add examples, with no runtime code modifications.

Overview
Documents automatic Markdown responses for known AI agents based on the User-Agent header (even without Accept: text/markdown) in the Markdown export guide.

Adds the recognized agent user-agents list, a curl example, and a note that normal browser traffic still receives HTML, across English, Spanish, and French versions of ai/markdown-export.mdx.

Reviewed by Cursor Bugbot for commit 768642e. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 14, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview May 14, 2026, 5:30 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants