Scan at scalePages with a broken Markdown twin
Pages with a broken Markdown twin
A per-URL report: one row per page that matches, over the pages a crawl reached.
What this report returns
A Markdown twin is an agent-friendly plain-Markdown copy of a page, advertised with <link rel="alternate" type="text/markdown" href="...">.
A row appears here when any of these is wrong, worst first:
- Wrong TypeThe alternate link (found by its .md href) doesn't declare a Markdown type (
text/markdown, or the unregisteredtext/x-markdown), so agents scanning by MIME type won't recognise it as a Markdown twin.Fix Addtype="text/markdown"to the <linkrel="alternate">. - Empty HrefThe Markdown alternate
<link>has an empty (or absent) href, so it advertises a twin without saying where it is. A Link header of <> is fine: it means this page.Fix Point href at the Markdown resource, e.g.href="/page.md".
The columns it shows
Every defect this technology can carry is a column in the grid, worst first, so nothing is hidden behind a filter you have to know to apply.
- Markdown Twin Valid
markdownTwinValid - Markdown Twin Findings
markdownTwinFindings - Markdown Twin Href
markdownTwinHref - Markdown Twin Declared Type
markdownTwinDeclaredType - Markdown Twin Wrong Type
markdownTwinWrongType - Markdown Twin Empty Href
markdownTwinEmptyHref
About Markdown twin
A clean low-token markdown version of the page for agents.
Read how Markdown twin is checked, including the specification it is validated against and a worked correct and broken example.
Running it
This report comes with Agentic Readiness in Lumar and appears on every crawl of any project that has it turned on. See the whole set, or check a single URL with the scanner on this site, which runs the same code with no account.