Tools / Markdown negotiation test
Markdown negotiation test
See whether docs or content pages support markdown-friendly delivery through content negotiation, alternate links, or obvious markdown endpoints.
Selected check · CONT-004-2 pts
What this checks
Accept header
Requests markdown-friendly content types.
Alternate links
Looks for markdown or text alternatives.
Docs suitability
Highlights docs and guide surfaces first.
Fallback copy
Checks whether HTML text is still readable.
FAQ
- What is markdown content negotiation?
- It means an agent can request a cleaner markdown or text representation of important public content, usually through Accept headers, alternate links, or stable markdown endpoints.
- Is markdown required for every page?
- No. Markdown is most valuable for docs, guides, changelogs, and long instructional pages. Short marketing pages can still be agent-readable when the HTML is semantic and complete.
- Will readable HTML still help if markdown is missing?
- Yes. The full report also checks whether primary content appears in initial HTML, headings are readable, and semantic structure gives agents enough context.
- What is the safest fix?
- Start with core docs and guides, expose markdown-friendly versions for those pages, and keep the markdown aligned with the public HTML rather than creating a stale duplicate.