Markdown 格式

OpenClaw 会先将出站 Markdown 转换为共享的中间表示 （IR），再渲染特定渠道的输出。IR 会保留纯文本以及 样式/链接范围，因此一次解析步骤即可供所有渠道使用，分块也永远不会 在格式范围中间拆分。

​

流程

1. 将 Markdown 解析为 IR（markdownToIR）- 纯文本加样式范围 （粗体、斜体、删除线、代码、代码块、剧透、块引用、 1-6 级标题）和链接范围。偏移量使用 UTF-16 代码单元，因此 Signal 样式 范围可以直接与它的 API 对齐。只有当渠道 选择表格模式时，才会解析表格。
2. 分块 IR（chunkMarkdownIR / renderMarkdownIRChunksWithinLimit）
   • 拆分发生在渲染前的 IR 文本上，因此内联样式和 链接会按块切片，而不会跨边界断开。
3. 按渠道渲染（renderMarkdownWithMarkers）- 样式标记映射 会将范围转换为渠道的原生标记。

​

IR 示例

输入 Markdown： OC_I18N_900000 IR（示意）： OC_I18N_900001

​

表格处理

markdown.tables 控制渠道如何转换 Markdown 表格，可按 渠道设置，也可选地按账号设置： 按渠道的插件默认值：Signal、WhatsApp 和 Matrix 默认使用 bullets；Mattermost 默认使用 off；Telegram 默认使用 block（除非账号启用了 richMessages，否则会 解析为 code）。任何没有显式插件默认值的 渠道都会回退到 code。 OC_I18N_900002

​

分块规则

• 分块限制来自渠道适配器/配置，并应用于 IR 文本，而不是 渲染后的输出。
• 围栏代码块会作为一个块保留，并带有尾随换行符，以便 渠道正确渲染闭合围栏。
• 列表和块引用前缀是 IR 文本的一部分，因此分块永远不会 在前缀中间拆分。
• 内联样式永远不会跨块拆分；渲染器会在下一个块的开头 重新打开未闭合的样式。

参见流式传输和分块，了解跨渠道的分块边界和 投递行为。

​

链接策略

• Slack： [label](url) -> <url|label>；裸 URL 保持裸 URL。
• Telegram： [label](url) -> <a href="url">label</a>（HTML 解析模式）。
• Signal： [label](url) -> label (url)，除非标签已经 与 URL 匹配。

​

剧透

会为 Signal（映射到 SPOILER 样式范围）和 Telegram（映射到 <tg-spoiler>）解析剧透标记（||spoiler||）。其他渠道会将 ||...|| 视为纯文本。

​

添加或更新渠道格式化器

1. 使用 markdownToIR(...) 解析一次，并传入适合渠道的 选项（autolink、headingStyle、blockquotePrefix、tableMode）。
2. 使用 renderMarkdownWithMarkers(...) 和样式标记映射渲染（或 为 Signal 这类传输协议使用自定义样式范围逻辑）。
3. 在渲染每个块之前，使用 chunkMarkdownIR(...) 或 renderMarkdownIRChunksWithinLimit(...) 分块。
4. 接入适配器，从出站发送路径调用新的分块器和渲染器。
5. 使用格式测试进行测试；如果渠道会分块，再加上出站投递测试。

​

常见问题

• Slack 尖括号标记（<@U123>、<#C123>、<https://...>）必须 在转义后保留；原始 HTML 仍需要安全转义。
• Telegram HTML 要求转义标签外的文本，以避免标记损坏。
• Signal 样式范围使用 UTF-16 偏移量，而不是码点偏移量。
• 保留围栏代码块的尾随换行符，让闭合标记 落在单独一行。

​

相关