--- title: "Markdown: o formato de texto limpo para agentes de IA | Grupo Marfre" description: "Markdown é um formato de texto simples com marcações leves. Veja por que ele entrega ao agente só o conteúdo, sem o código da página, e onde ele aparece." canonical: https://grupomarfre.com.br/sites-agenticos/markdown/ alternate_html: https://grupomarfre.com.br/sites-agenticos/markdown/ language: pt-BR last_updated: 2026-10-27 type: guia --- # Markdown: o formato de texto limpo para agentes de IA **Resposta rápida:** Markdown é um formato de texto simples em que símbolos leves marcam a estrutura: # para título, - para lista, \[texto\](url) para link. Sem menu, script nem estilo, o agente de IA lê só o conteúdo. Por isso o llms.txt e o espelho .md de cada página usam esse formato. Markdown é um formato de texto puro em que a estrutura (títulos, listas, links) é marcada com símbolos comuns do teclado. Um arquivo `.md` abre em qualquer editor e é legível mesmo sem programa nenhum. Para agentes de IA, a vantagem é a ausência de ruído: o arquivo traz o conteúdo e a hierarquia, sem o código de apresentação que envolve a página. ## O que é Markdown? Markdown é uma linguagem de marcação leve. Você escreve texto normal e acrescenta poucos símbolos para indicar o que é título, lista ou link. O arquivo continua sendo texto, sem tags de abertura e fechamento, e qualquer sistema consegue ler e converter. ## Por que entregar Markdown em vez de HTML ao agente? Porque o HTML de uma página mistura conteúdo com menu, rodapé, scripts e regras de estilo, e o agente precisa separar o que importa. No Markdown essa separação já foi feita: sobra o texto, os títulos e os links. O leitor automático recebe só o que a página diz. Comparação com o mesmo trecho: ```html

Horário de atendimento

De segunda a sexta, das 8h às 18h.

``` ```markdown ## Horário de atendimento De segunda a sexta, das 8h às 18h. ``` Esse ganho depende de a página ter conteúdo de verdade. Veja em [como um assistente de IA lê um site](https://grupomarfre.com.br/sites-agenticos/como-assistentes-de-ia-leem-um-site/) o que o agente enxerga em cada caso. ## Quais símbolos de Markdown você mais usa? Cinco marcações cobrem o básico de uma página de site: | Você quer | Escreve | | --- | --- | | Título de seção | `## Título` | | Lista com marcadores | `- item` | | Lista numerada | `1. passo` | | Link | `[texto](https://exemplo.com.br/)` | | Ênfase | `**importante**` | O número de `#` define o nível do título, o que mantém a hierarquia h1, h2 e h3 visível no próprio texto. ## Onde o Markdown aparece em um site agêntico? Aparece em dois lugares: no `llms.txt` e no espelho `.md` de cada página. O llms.txt, proposta do llmstxt.org, é um arquivo Markdown na raiz do site com H1 com o nome, citação em bloco com o resumo e seções com listas de links. Veja [o que é llms.txt](https://grupomarfre.com.br/sites-agenticos/llms-txt/). Exemplo fictício de llms.txt: ```markdown ## Clínica Exemplo > Clínica de fisioterapia em Belo Horizonte (MG), com atendimento de segunda a sábado. ## Serviços - [Fisioterapia ortopédica](https://clinicaexemplo.com.br/fisioterapia.md): avaliação e tratamento - [Pilates clínico](https://clinicaexemplo.com.br/pilates.md): aulas em grupo reduzido ``` A v2 do llms.txt traz o espelho em `pagina.md` ou `pagina.html.md`, descoberto por `rel="alternate" type="text/markdown"`. Na régua do Grupo Marfre, o espelho sai da mesma fonte do HTML, nunca é redigido à parte, e abre com frontmatter YAML (veja [os campos que importam](https://grupomarfre.com.br/sites-agenticos/frontmatter-do-markdown/)). Para saber como gerar, leia [espelho em Markdown de cada página](https://grupomarfre.com.br/sites-agenticos/espelho-markdown-por-pagina/). ## Quem recebe o Markdown e quem recebe o HTML? Na régua do Grupo Marfre, o `.md` é servido a quem manda `Accept: text/markdown`, a quem acrescenta `?mode=agent` ou ao user-agent de robô de IA. Googlebot e Bingbot recebem o HTML, que é a versão canônica. O `.md` leva `X-Robots-Tag: noindex` e fica fora do sitemap, para não virar conteúdo duplicado. A mecânica está em [negociação de conteúdo](https://grupomarfre.com.br/sites-agenticos/negociacao-de-conteudo-markdown/). ## Perguntas frequentes ### Preciso aprender uma linguagem de programação para usar Markdown? Não. São símbolos simples, como `#` e `-`, que se aprendem em minutos. Na régua do Grupo Marfre, o espelho é gerado automaticamente da mesma fonte do HTML, e ninguém escreve o .md à mão. ### O Markdown substitui o HTML do meu site? Não. O visitante continua vendo o HTML. O Markdown é uma versão paralela do mesmo conteúdo, oferecida a agentes que pedem esse formato. ### Ter arquivos .md garante que a IA vai citar meu site? Não. O formato facilita a leitura, mas a decisão de citar é do modelo. Ele também não substitui conteúdo útil e claro na página. ### Todo arquivo com cabeçalho de Markdown deve ficar público? Não. Arquivos de ferramenta que sobem junto no deploy, como README e configurações, precisam ser barrados. Na prática do Grupo Marfre, um `/README` sem barreira virou `/README.md` e saiu inteiro para robôs. ## Fontes consultadas - [llmstxt.org/](https://llmstxt.org/) ## Leia também ### [O que é llms.txt e para que serve](https://grupomarfre.com.br/sites-agenticos/llms-txt/) llms.txt é um arquivo Markdown na raiz do site que resume o negócio para IA. Veja o formato, quem lê, a diferença para robots.txt e sitemap e se vale criar. ### [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. ### [Negociação de conteúdo: servir Markdown a quem pede Accept: text/markdown](https://grupomarfre.com.br/sites-agenticos/negociacao-de-conteudo-markdown/) Negociação de conteúdo em Markdown: como servir o .md a quem manda Accept: text/markdown, ?mode=agent ou user-agent de IA, e testar tudo com curl. ### [Frontmatter YAML no espelho Markdown: os campos que importam](https://grupomarfre.com.br/sites-agenticos/frontmatter-do-markdown/) Frontmatter YAML no espelho Markdown: os 7 campos (title, description, canonical, alternate\_html, language, last\_updated, type), exemplo e erros de formato. ### [Como um assistente de IA lê um site](https://grupomarfre.com.br/sites-agenticos/como-assistentes-de-ia-leem-um-site/) Veja como um assistente de IA lê um site, do índice à citação, e os quatro pontos onde ele pode perder a vez: JavaScript, robô barrado, fato divergente e lentidão. ### [Agente de IA: o que é](https://grupomarfre.com.br/sites-agenticos/agente-de-ia/) Agente de IA é um sistema que recebe um objetivo e executa os passos sozinho com ferramentas. Veja a diferença para chatbot e o efeito no seu site. --- ## 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/markdown/