---
title: "Markdown alternate link · Sitebulb Labs"
description: "A rel=\"alternate\" link pointing to text/markdown tells an agent a Markdown copy exists, so it does not have to guess."
url: https://labs.sitebulb.com/docs/checks/content-accessibility/markdown-link-alternate/
---

# 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.

- Category

  [Content accessibility](https://labs.sitebulb.com/docs/checks/content-accessibility)

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

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

Or send the equivalent response header:

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

Related: [Markdown URL fallback](https://labs.sitebulb.com/docs/checks/content-accessibility/markdown-url-fallback) and [Link response headers](https://labs.sitebulb.com/docs/checks/discoverability/link-headers).
