Should HTML and markdown live at the same URL?

They can, as long as Vary: Accept is set and caches keep the representations separate.

Is markdown required for AI readiness?

No. It is an optimization for extraction quality, especially on docs, guides, methodology, and fix pages.

Fix guide

A no markdown response finding means the page did not provide a clean text/markdown representation when explicitly requested by an agent.

Answer first

The page returned HTML, an error, or an ambiguous content type for an Accept: text/markdown request.

Detail 01

Add content negotiation for high-value public pages, render concise markdown from the same source content, and send Vary: Accept.

Detail 02

Use curl with Accept: text/markdown, check content type and Vary headers, confirm links are absolute or root-relative, then re-scan.

FAQ

Should HTML and markdown live at the same URL?: They can, as long as Vary: Accept is set and caches keep the representations separate.
Is markdown required for AI readiness?: No. It is an optimization for extraction quality, especially on docs, guides, methodology, and fix pages.