Browse sections
What does this check look at?
The document head contains a <link> with rel="alternate" and type="text/markdown", in either attribute order.
What does a failure mean?
No markdown alternate is declared on the page.
This reads the declaration only. The scanner fetches one URL, so it does not follow the alternate to confirm that it resolves, and a page can pass this check while pointing at a link that 404s. That limitation is stated here rather than hidden; closing it means a second request in the fetcher.
How do I fix it?
- Publish a markdown version of the page and point at it with <link rel="alternate" type="text/markdown" href="...">, so an agent can fetch the content without the chrome around it.
Why is it worth 1 point?
Points are relative weights inside a dimension, and a dimension's weight decides how much of the total it can move. The reasoning for this dimension's weight is published rather than asserted:
| Dimension | AI Context Files — 5% of the total score |
| Points for this check | 1 of 6 in this dimension |
| Worth at most | 0.8 of the 100 points |
Deliberately low. The check is worth 4 of this dimension's 6 points and the dimension carries 5% of the total, so the file is capped at 3.3 of the 100. It is scored because the convention is cheap to follow, not because it moves a ranking.
Which dimension does this belong to?
AI Context Files — 5% of the total score, decided by 3 published rules.
A cheap and optional signal: one URL that lets a site state its own context for machines. Publishing it is easy; whether any engine reads it is not something this method measures.
The fix for this rule is walked through step by step in the llms txt deployment guide.
What else is measured in this dimension?
- /llms.txt is present and structured — 4 points
- A crawler policy is published — 1 point
How do I see my own result?
Run a scan on your own domain. The report lists every failed check with the evidence that produced it, so you can tell a real failure from a check that does not apply.
Run a free GEO audit on your own site →
The full method, including the dimensions that are deliberately weighted low and the parts of a picture a single-URL scan cannot see, is on the methodology page.
Questions about this rule
What does this check look at?
The document head contains a <link> with rel="alternate" and type="text/markdown", in either attribute order.
What does failing it mean?
No markdown alternate is declared on the page.
Why does this dimension carry 5% of the score?
Deliberately low. The check is worth 4 of this dimension's 6 points and the dimension carries 5% of the total, so the file is capped at 3.3 of the 100. It is scored because the convention is cheap to follow, not because it moves a ranking.
Evidence and sources
GEO can boost visibility by up to 40% overall in generative engine responses, and in the paper's Table 1 the best of the tested methods improve on the no-optimization baseline by 41% and 28%. — Generative Engine Optimization, KDD 2024
This rule is applied by the scanner and published in the rule set it is read from, so the condition on this page is the condition the scan tests rather than a summary of it.
Primary sources
- Generative Engine Optimization (KDD 2024) — the measured gains the citability weight follows
- What Generative Search Engines Like — what generative engines prefer in retrieved content
- What Gets Cited: Competitive GEO — which of two competing sources is cited first
- The rule set and its weights — every check, its weight and its pass condition