Update from code changes: Markdown 404 recovery guidance - #7281
Merged
Conversation
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
dks333
approved these changes
Sep 6, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Missing pages requested as Markdown now return a 404 with a Markdown body that helps AI tools recover. The response links to the documentation index (
llms.txt), the full documentation file (llms-full.txt), and up to three related pages based on the requested path. Sites that use authentication omit suggestions and return only the documentation links. TheLinkandX-Llms-Txtdiscovery headers now also appear on Markdown responses and 404 pages. See https://github.com/mintlify/mint/pull/10806.Changes
/ai/markdown-exportwith an example Markdown 404 response./ai/llmstxtto note that discovery headers appear on Markdown responses and 404 pages.Note
Low Risk
Documentation-only changes with no runtime or security impact.
Overview
This PR updates the AI docs to match platform behavior from mint#10806: Markdown 404 recovery and broader discovery headers.
Markdown export now documents a Missing pages section: requesting a non-existent page as Markdown returns 404 with a Markdown body that points agents at
llms.txt,llms-full.txt, and up to three related pages (same search as the custom 404 page). Authenticated sites only return the index links, not related suggestions. An example response is included.llms.txt clarifies that
LinkandX-Llms-Txtdiscovery headers are sent on every response, not just normal HTML pages—specifically including Markdown responses and 404 pages.The same content updates are mirrored in es, fr, and zh (
markdown-exportandllmstxt).Reviewed by Cursor Bugbot for commit 3a17d34. Bugbot is set up for automated code reviews on this repo. Configure here.