Discourse passa a oferecer endpoints Markdown para tópicos e listas

O Discourse passou a servir tópicos e listas de tópicos em Markdown processado. Há duas formas de pedir: adicionar o sufixo .md na URL ou enviar o header Accept: text/markdown, sem mudar a URL. A equipe diz que agentes e LLMs provavelmente não precisam de configuração, porque já mandam esse header.

A motivação é comparar com os formatos que já existiam. O HTML obriga o agente a limpar layout, estilos e scripts, o que gasta tokens e pode errar na extração. O .raw traz a sintaxe própria do Discourse (shortcodes de uploads, citações e enquetes) e falha com imagens, listas e tabelas. No endpoint Markdown, o Discourse processa essa sintaxe antes, então imagens, listas, tabelas e formatação saem corretas. Listas paginadas trazem links de anterior e próxima em Markdown, para o agente percorrer o conjunto inteiro.

O recurso nasceu do plugin Discourse to Markdown, criado por Ben Word, que também escreveu a especificação Accept Markdown. Agora está no core. Quem usa o plugin deve desativá-lo e desinstalá-lo, pois ele substitui alguns endpoints do core. Para sites atrás da Cloudflare, a conversão HTML para Markdown da própria Cloudflare pode interceptar requisições com Accept: text/markdown e servir a versão dela. O teste sugerido é comparar a resposta com o recurso ligado e desligado. Nos sites hospedados, o recurso já vem ativo em Upcoming Changes; quem faz self-host precisa atualizar. Para desligar, use a configuração enable_markdown_endpoints no painel de admin.

O movimento segue uma linha que o CEVIU vinha registrando. Em 13 de fevereiro de 2026, o CEVIU noticiou "Apresentando Markdown para Agentes", recurso da Cloudflare que converte HTML em Markdown em tempo real quando o cliente pede text/markdown via header Accept. Em 5 de março de 2026, noticiou que o WordPress.org passou a oferecer saída em Markdown por parâmetros de URL e cabeçalhos HTTP. E em 27 de agosto de 2026, o CEVIU publicou "Otimizando a Interação entre IA e Conteúdo Web com Markdown e Accept Headers". A diferença agora é que a conversão acontece na origem, dentro do Discourse, e não na borda da rede. É também o ponto de contato com a Cloudflare, que pode interceptar o header antes do site.

Para quem opera um fórum Discourse, a leitura é que o conteúdo ganha uma interface pronta para agentes sem trabalho extra, mas vale testar o comportamento atrás de CDN. Para quem desenvolve integrações, tende a acabar a necessidade de escrever parser de HTML ou traduzir sintaxe raw. Cada plataforma de conteúdo que adota o mesmo padrão de header reforça o Accept: text/markdown como convenção.