Discourse теперь поддерживает нативные Markdown-эндпоинты, что упрощает чтение контента форумов для ИИ-инструментов и других клиентов без необходимости парсить полные HTML-страницы.
Эта функция будет включена по умолчанию на всех хостинговых сайтах через систему Upcoming Changes. Администраторы, желающие отказаться от её использования, могут сделать это, отключив настройку сайта enable_markdown_endpoints.
Особая благодарность @benword за создание оригинального плагина Discourse to Markdown, который стал предшественником этой функции в ядре Discourse.
Markdown-вывод генерируется из отрендеренного («cooked») HTML постов, сохраняя контент, который видят читатели, включая раскрытые ссылки и обработанное форматирование. Специфичные для Discourse элементы, такие как цитаты, oneboxes, блоки кода, опросы и сворачиваемые секции, преобразуются обратно в Markdown. Ответы на темы включают метаданные и ссылки на пагинацию, а преобразованные тела постов кэшируются с использованием дайджеста содержимого, чтобы при редактировании создавался новый вывод.
Клиенты могут явно запрашивать Markdown через URL с расширением .md или отправляя заголовок Accept: text/markdown. Переговоры учитывают значения качества и выбирают Markdown, если он предпочтительнее HTML и JSON; явные запросы .md сохраняют свои форматы. Поддерживаемые HTML-страницы указывают на свой Markdown-эквивалент через HTTP-заголовок Link и элемент <link rel="alternate">.