# 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 Type**The alternate link (found by its .md href) doesn't declare a Markdown type (`text/markdown`, or the unregistered `text/x-markdown`), so agents scanning by MIME type won't recognise it as a Markdown twin.**Fix** Add `type="text/markdown"` to the &lt;link `rel="alternate"`&gt;.
-   **Empty Href**The 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](https://agentic-readiness.lumar.io/docs/content/markdown-twin), 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](https://agentic-readiness.lumar.io/scan-at-scale), or check a single URL with the [scanner on this site](https://agentic-readiness.lumar.io/), which runs the same code with no account.

[Get Lumar pricing →](https://www.lumar.io/pricing/)