Skip to content

Update from code changes: Markdown 404 recovery guidance - #7281

Merged
dks333 merged 1 commit into
mainfrom
mintlify/d71c36e3
Sep 6, 2026
Merged

Update from code changes: Markdown 404 recovery guidance#7281
dks333 merged 1 commit into
mainfrom
mintlify/d71c36e3

Conversation

@mintlify

@mintlify mintlify Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

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. The Link and X-Llms-Txt discovery headers now also appear on Markdown responses and 404 pages. See https://github.com/mintlify/mint/pull/10806.

Changes

  • Added a "Missing pages" section to /ai/markdown-export with an example Markdown 404 response.
  • Updated /ai/llmstxt to note that discovery headers appear on Markdown responses and 404 pages.
  • Mirrored both updates in the es, fr, and zh translations.

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 Link and X-Llms-Txt discovery 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-export and llmstxt).

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

@mintlify

mintlify Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated
mintlify 🟢 Ready View Preview Sep 6, 2026, 6:29 AM

@mintlify

mintlify Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated
tomee 🟡 Building Sep 6, 2026, 6:28 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

@dks333
dks333 merged commit 1944215 into main Sep 6, 2026
5 checks passed
@dks333
dks333 deleted the mintlify/d71c36e3 branch September 6, 2026 06:30
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.

1 participant