Markdown alternate link

A rel="alternate" link pointing to text/markdown tells an agent a Markdown copy exists, so it does not have to guess.

Standard
Emerging checkEmerging
Off by default, turn on in settings

What it checks

The extension looks for a link to a Markdown copy of the page in two places:

  • The HTTP Link response header, with type="text/markdown".
  • A <link rel="alternate"> element on the rendered page with a text/markdown type.

Results

Status When
Pass A Markdown alternate is advertised in the Link header or the page
N/A No Markdown alternate is advertised

How to fix

Add a <link> element to the page’s <head> pointing to its Markdown copy:

<link rel="alternate" type="text/markdown" href="https://example.com/docs/setup.md" />

Or send the equivalent response header:

Link: <https://example.com/docs/setup.md>; rel="alternate"; type="text/markdown"

Related: Markdown URL fallback and Link response headers.