HTML2Markdown 自适应

Markdown 已迅速成为 Agents 和整个 AI 系统的通用语言。这种格式清晰的结构使其非常适合 AI 处理，最终在减少 Token 消耗的同时带来更优的结果。
Kodo 对象存储现已支持空间级 HTML2Markdown 自动转换能力，支持在指定情况下自动将 HTML 文件类型响应为 Markdown 内容。

功能优势

• 简单： 内容协商，服务端按需决策是否转换，无需修改文件存储结构，无需重写下载逻辑
• 便捷： 对携带请求头的 HTML 文件自动转换，无需人为预处理
• 降本： 无需额外存储 Markdown 版本；直接使用 Markdown 内容，显著降低 AI 推理成本

使用限制

• 不允许在泛域名（以 . 开头的域名）上启用
• 需确保 MIME 类型正确设置为 text/html，类型为 application/octet-stream 的文件不会触发转换

使用方式

针对开启了该功能的空间和域名，当下载请求携带 Accept: text/markdown 请求头时，Kodo 即可自动对 text/html 类型的文件触发 HTML2Markdown 转换，自动返回 Markdown 内容。
关于 HTML2Markdown 自适应功能转换能力及容错机制

应用示例：下载时直接转换

功能开启后，客户端只需在请求头中声明偏好：

curl -H "Accept: text/markdown" "http://<domain>/<key>.html"

成功触发转换时的响应：

HTTP/1.1 200 OK
Content-Type: text/markdown
Vary: Accept

markdown 内容

响应头说明

查看 Agent 场景中的 Markdown 最佳实践 获取更多应用示例

启用功能

HTML2Markdown 自适应功能，暂时不支持自助开启、需后台配置，如有需求请您联系您的商务，或是提交工单申请。

计费

邀测期间暂不收费。