O Discourse agora suporta endpoints nativos em Markdown, facilitando a leitura do conteúdo do fórum por ferramentas de IA e outros clientes, sem a necessidade de analisar páginas HTML completas.
Este recurso será ativado por padrão em todos os sites hospedados por meio do sistema de Próximas Alterações. Administradores que desejarem desativá-lo podem fazê-lo desabilitando a configuração do site enable_markdown_endpoints.
Muito obrigado ao @benword por criar o plugin original Discourse to Markdown, que foi o precursor deste recurso no núcleo do Discourse.
A saída em Markdown é gerada a partir do HTML renderizado (“cozido”) das publicações, preservando o conteúdo visto pelos leitores, incluindo links expandidos e formatação processada. Elementos específicos do Discourse, como citações, oneboxes, blocos de código, enquetes e seções recolhíveis, são convertidos de volta para Markdown. As respostas de tópicos incluem metadados e links de paginação, e os corpos das publicações convertidos são armazenados em cache usando um resumo de conteúdo, garantindo que edições gerem uma saída atualizada.
Os clientes podem solicitar explicitamente o formato Markdown por meio de URLs com .md ou enviando o cabeçalho Accept: text/markdown. A negociação respeita os valores de qualidade e seleciona o Markdown quando ele é preferível ao HTML e ao JSON; solicitações explícitas com .md mantêm seus formatos. As páginas HTML suportadas anunciam seu equivalente em Markdown por meio de um cabeçalho HTTP Link e de um elemento <link rel="alternate">.