---
title: "A tag link rel=\"alternate\" type=\"text/markdown\" | Grupo Marfre"
description: "Como escrever a tag link rel=“alternate” type=“text/markdown” no head, injetá-la na borda e contar com curl quais páginas do site anunciam o espelho .md."
canonical: https://grupomarfre.com.br/sites-agenticos/link-rel-alternate-markdown/
alternate_html: https://grupomarfre.com.br/sites-agenticos/link-rel-alternate-markdown/
language: pt-BR
last_updated: 2026-10-27
type: guia
---
# A tag link rel="alternate" type="text/markdown"

**Resposta rápida:** A tag <link rel="alternate" type="text/markdown" href="..."> fica no <head> do HTML e avisa ao agente que a página tem uma versão em Markdown, em endereço próprio (pagina.md). Escreva uma por página, com href apontando o espelho daquela página. Se o site usa várias ferramentas, injete a tag na borda e conte as páginas com curl.

A tag `<link rel="alternate" type="text/markdown">` é um aviso dentro do `<head>` de cada página HTML: "existe uma versão desta página em Markdown, neste endereço". Quem lê o HTML encontra o caminho do espelho sem precisar adivinhar a URL.

O que dá trabalho não é escrever a tag, que tem uma linha. É garantir que todas as páginas a tenham, inclusive as geradas por ferramentas diferentes. As seções abaixo mostram a sintaxe, o motivo de injetá-la na borda e um jeito de contar a cobertura.

## O que a tag faz e o que ela não faz?

Ela anuncia o espelho. Segundo a proposta do llmstxt.org (versão 2), o espelho fica em `pagina.md` ou `pagina.html.md` e é descoberto justamente por `rel="alternate" type="text/markdown"`. A tag não gera o arquivo, não força nenhum robô a lê-lo e não garante citação por IA. Ela só torna o espelho encontrável.

Na régua do Grupo Marfre, a tag é uma de três pistas que apontam para o mesmo espelho. As outras duas são o cabeçalho `Link` (veja [Cabeçalho Link (RFC 8288)](https://grupomarfre.com.br/sites-agenticos/cabecalho-link-rfc-8288/)) e a negociação por `Accept: text/markdown`. A tag vale para quem já tem o HTML em mãos. O cabeçalho vale para quem lê só a resposta HTTP.

O espelho em si, sua geração e seu frontmatter estão em [Espelho em Markdown de cada página](https://grupomarfre.com.br/sites-agenticos/espelho-markdown-por-pagina/).

## Como escrever a tag?

Uma tag por página, dentro do `<head>`, com o `href` apontando o espelho daquela página específica:

```html
<head>
  <link rel="canonical" href="https://www.exemplo.com.br/servicos/consultoria/">
  <link rel="alternate" type="text/markdown"
        href="https://www.exemplo.com.br/servicos/consultoria.md">
  <link rel="describedby" href="https://www.exemplo.com.br/llms.txt">
</head>
```

(Empresa e endereços fictícios.) Pontos de atenção:

1.  **O `href` é por página.** Um mesmo `href` copiado para o site inteiro aponta todo mundo para o espelho errado. É o risco do valor fixo no template.
2.  **Use o endereço completo ou relativo à raiz.** Evite caminho relativo sem barra inicial, que muda de sentido conforme a profundidade da página.
3.  **O `type` é exatamente `text/markdown`.** Variações de grafia quebram a descoberta por quem procura esse valor.
4.  **O `describedby` é opcional, mas complementar.** Na v2 do llms.txt, ele liga a página ao llms.txt (em `<link>` ou no cabeçalho `Link`). Detalhes em [llms.txt v2](https://grupomarfre.com.br/sites-agenticos/llms-txt-v2/).

## Por que injetar na borda quando o site é gerado por várias ferramentas?

Porque editar o `<head>` em cada ferramenta cria buracos. Um site pode misturar um gerador estático para as páginas de serviço, um WordPress no blog e um construtor numa landing page. Cada um tem seu template, seu jeito de pôr tags no `<head>` e, às vezes, nenhuma permissão para isso.

No método do Grupo Marfre, a tag nasce na camada de borda: um middleware (Cloudflare Pages Functions) que já negocia o Markdown por `Accept: text/markdown`, por `?mode=agent` e por user-agent de robô de IA. O mesmo middleware acrescenta `Vary`, `Link` e o `<link rel="alternate">` nas respostas. O HTML da origem não precisa saber que o espelho existe.

Vantagens dessa escolha:

- A regra vive num lugar só. Página nova, de qualquer ferramenta, já sai com a tag.
- O `href` é calculado a partir do caminho da própria requisição, o que evita o erro do `href` copiado.
- Googlebot e Bingbot continuam recebendo o HTML (a canônica), agora com a tag no `<head>`. O espelho `.md` sai com `X-Robots-Tag: noindex` e fica fora do sitemap, para não virar conteúdo duplicado.

O passo a passo da implementação está em [Camada agêntica no Cloudflare Pages com Pages Functions](https://grupomarfre.com.br/sites-agenticos/middleware-cloudflare-pages/).

## Como contar se todas as páginas têm a tag?

Parta do sitemap (na régua do Grupo Marfre, ele só lista HTML) e peça cada página com curl comum, sem user-agent de robô de IA. Com o user-agent de robô você receberia o `.md` em vez do HTML, e o teste olharia a página errada.

```bash
curl -s https://www.exemplo.com.br/sitemap.xml \
  | grep -o '<loc>[^<]*</loc>' | sed 's/<[^>]*>//g' > urls.txt

total=0; com=0
while read -r url; do
  total=$((total+1))
  if curl -s "$url" | grep -Eqi '<link[^>]*type="text/markdown"'; then
    com=$((com+1))
  else
    echo "SEM TAG: $url"
  fi
done < urls.txt
echo "$com de $total páginas anunciam o espelho"
```

O resultado esperado é "N de N". Cada linha "SEM TAG" aponta uma página fora da regra, por exemplo de uma ferramenta que escapou da borda. Se o sitemap for um índice de sitemaps, rode o comando em cada arquivo filho.

Esse teste só confirma que a tag existe. Escolha algumas páginas e confira o destino de cada `href`:

```bash
curl -s -D - https://www.exemplo.com.br/servicos/consultoria.md | head -n 25
```

O comando faz um GET comum e mostra os cabeçalhos e o começo do corpo. Verifique se a resposta é 200, se o conteúdo é Markdown (não HTML) e se há `X-Robots-Tag: noindex`. Outras receitas de teste estão em [Como testar a camada agêntica com curl](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/).

Repita a contagem a cada publicação relevante e sempre depois de trocar tema, plugin ou regra de cache. Qualquer um deles pode apagar a injeção sem aviso.

## Perguntas frequentes

### A tag precisa estar em todas as páginas?

Em todas as que têm espelho. Na régua do Grupo Marfre, toda página HTML do sitemap tem espelho, então todas levam a tag. Página sem espelho não deve ter a tag, porque ela apontaria para um endereço que não existe.

### Posso usar só o cabeçalho Link e dispensar a tag?

Pode, mas as duas pistas se complementam. O cabeçalho serve a quem lê a resposta HTTP, e a tag serve a quem recebe o HTML. O Grupo Marfre mantém as duas.

### A tag ajuda no ranking do Google?

Não há base para dizer isso. Nenhuma fonte oficial consultada trata a tag como sinal de ranking. Sobre o llms.txt, da mesma proposta, o Google declarou, em 15/06/2026, que a Busca não precisa dele e que ele não afeta o ranking. A tag serve a sistemas que leem Markdown, e o Googlebot continua recebendo o HTML.

### Instalei a tag e a IA ainda não me cita. Deu errado?

Não necessariamente. A tag torna o espelho descobrível, mas a escolha de citar é do modelo. Meça a presença nas IAs por um método próprio (veja [Como medir se a IA cita sua empresa](https://grupomarfre.com.br/sites-agenticos/medir-se-a-ia-cita/)) em vez de usar a tag como prova.

## Fontes consultadas

- [llmstxt.org/](https://llmstxt.org/)

## Leia também

### [Espelho em Markdown de cada página: o que é e como gerar](https://grupomarfre.com.br/sites-agenticos/espelho-markdown-por-pagina/)

Espelho em Markdown de cada página: o que é, como nomear o arquivo .md, gerar da mesma fonte do HTML, o que tirar e como evitar conteúdo duplicado.

### [llms.txt v2: espelho .md e rel="describedby"](https://grupomarfre.com.br/sites-agenticos/llms-txt-v2/)

llms.txt v2: espelho pagina.md, descoberta por rel=alternate e ligação por rel=describedby. Veja exemplos de cabeçalho e como migrar de rel=llms-txt.

### [Cabeçalho Link (RFC 8288): como o agente descobre a versão em Markdown](https://grupomarfre.com.br/sites-agenticos/cabecalho-link-rfc-8288/)

Cabeçalho Link (RFC 8288): como apontar o espelho .md, o llms.txt e o sitemap por HTTP, com formato, exemplo e teste com curl, sem baixar o HTML.

### [Camada agêntica no Cloudflare Pages com Pages Functions](https://grupomarfre.com.br/sites-agenticos/middleware-cloudflare-pages/)

Guia para montar a camada agêntica no Cloudflare Pages com Pages Functions (Markdown por Accept, Vary, Link, 404 em Markdown) e provar com curl.

### [Como testar a camada agêntica com curl (receitas prontas)](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/)

Receitas de curl para testar a camada agêntica: Accept text/markdown, ?mode=agent, GPTBot, Googlebot, Vary, Link, 404 e robots.txt, com a saída esperada.

### [Cabeçalho Vary: por que o site agêntico precisa dele](https://grupomarfre.com.br/sites-agenticos/cabecalho-vary/)

Cabeçalho Vary avisa ao cache que a mesma URL tem versão HTML e Markdown. Veja o que a borda da Cloudflare respeita, quando incluir User-Agent e como conferir.

---

## Sobre o Grupo Marfre

Grupo Marfre Automação e Tecnologia LTDA (CNPJ 49.685.676/0001-55): agência de marketing digital e inteligência artificial com base em Contagem/MG, que atende o Brasil inteiro de forma remota.

- Endereço: Alameda das Cotovias, 75, Cabral, Contagem - MG, Brasil
- WhatsApp: (31) 93618-7272, https://wa.me/5531936187272
- E-mail: contato@grupomarfre.com.br
- Instagram: https://instagram.com/marfregrupo
- Serviços: gestão de tráfego pago (Meta Ads e Google Ads), site agêntico (site pronto pra assistentes de IA lerem), site que vira contato, SEO e Google, IA no WhatsApp, CRM e automação
- Serviço de site agêntico: https://grupomarfre.com.br/servicos/site-agentico/ · serviço de gestão de tráfego: https://grupomarfre.com.br/servicos/gestao-de-trafego/
- Guias: https://grupomarfre.com.br/sites-agenticos/ e https://grupomarfre.com.br/gestao-de-trafego/
- Método em 4 etapas: Diagnóstico, Estratégia, Execução, Otimização
- Segmentos já atendidos: clínica, consultório, advocacia, loja, igreja
- Preço e escopo não são publicados: são definidos por diagnóstico, caso a caso
- Todas as páginas em Markdown: https://grupomarfre.com.br/llms.txt · conteúdo completo: https://grupomarfre.com.br/llms-full.txt

Página HTML equivalente: https://grupomarfre.com.br/sites-agenticos/link-rel-alternate-markdown/