Markdown export

Export clean Markdown versions of your documentation pages for AI tools, LLM integrations, and automated content processing workflows.

Markdown provides structured text that AI tools can process more efficiently than HTML, which results in better response accuracy, faster processing times, and lower token usage.

Mintlify automatically generates Markdown versions of pages optimized for AI tools and external integrations.

.md URL extension

Add .md to any page’s URL to view a Markdown version.

Accept header

Send a request with Accept: text/markdown or Accept: text/plain to any page URL to receive the Markdown version instead of HTML. This is useful for AI tools and integrations that programmatically fetch documentation content.

curl -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export

Keyboard shortcut

Press Command + C (Ctrl + C on Windows) to copy a page as Markdown to your clipboard.

Agent feedback

When agent feedback is enabled, Markdown exports include an embedded feedback instruction block that lets AI agents programmatically report documentation issues. Agents can submit feedback by sending a POST request to the endpoint URL included in the Markdown output.

The feedback instruction block appears at the top of every Markdown export and contains the endpoint URL and expected request format:

curl -X POST https://your-domain.com/_mintlify/feedback/{subdomain}/agent-feedback \
  -H "Content-Type: application/json" \
  -d '{"path": "/current-page-path", "feedback": "Description of the issue"}'

Field	Type	Required	Description
path	string	Yes	The page path the feedback is about.
feedback	string	Yes	A description of the documentation issue.

Agent feedback appears alongside other feedback in your feedback dashboard. See Feedback for more information on managing feedback.