LLMention
← All 40 checksAI Context Files

A markdown alternate is declared

One of 40 checks the scanner runs. This one is worth 1 point inside the AI Context Files dimension, which carries 5% of the total score.

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?

  1. 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:

DimensionAI Context Files — 5% of the total score
Points for this check1 of 6 in this dimension
Worth at most0.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?

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