Discourse 核心现已包含用于主题列表和视图的 Markdown 端点

Discourse 现在支持原生的 Markdown 端点,这使得 AI 工具和其他客户端能够更轻松地读取论坛内容,而无需解析完整的 HTML 页面。

该功能将通过“即将推出的更改”系统在所有托管站点上默认启用。希望选择退出的管理员可以通过禁用 enable_markdown_endpoints 站点设置来实现。

非常感谢 @benword 创建了最初的 Discourse to Markdown 插件,它是 Discourse 核心中此功能的前身。


Markdown 输出是根据帖子渲染后的(“cooked”)HTML 生成的,保留了读者看到的内容,包括展开的链接和已处理的格式。Discourse 特有的元素,如引用、onebox、代码块、投票和可折叠部分,会被转换回 Markdown。主题回复包含元数据和分页链接,并且转换后的帖子正文会使用内容摘要进行缓存,以便在编辑时生成新的输出。

客户端可以通过 .md URL 或发送 Accept: text/markdown 头来明确请求 Markdown。协商机制会尊重质量值,并在 Markdown 优于 HTML 和 JSON 时选择 Markdown;明确的 .md 请求将保留其格式。支持的 HTML 页面会通过 HTTP Link 头和一个 <link rel="alternate"> 元素来宣传其 Markdown 等效版本。

20 个赞

你能说明一下哪些主题列表是支持的,哪些是不支持的吗?

由于我目前使用的是原始的 Discourse-to-Markdown 插件,为了避免输出冲突,我是否需要将其禁用并移除?请给出建议。