Markdown 格式化

​

流水线

1. 将 Markdown 解析为 IR (markdownToIR) - 纯文本加样式范围 （粗体、斜体、删除线、代码、代码块、spoiler、blockquote、 1-6 级标题）以及链接范围。偏移量使用 UTF-16 代码单元，因此 Signal 风格的 范围可以直接与其 API 对齐。只有当频道启用表格模式时，表格才会被解析。
2. 对 IR 进行分块 (chunkMarkdownIR / renderMarkdownIRChunksWithinLimit)
   • 分块发生在渲染之前的 IR 文本上，因此内联样式和链接会按每个块切分， 而不是跨越边界被截断。
3. 按频道渲染 (renderMarkdownWithMarkers) - 样式标记映射 会将范围转换为该频道的原生标记语言。

​

IR 示例

Hello **world** - see [docs](https://docs.openclaw.ai).

{
  "text": "你好 world - 查看 docs.",
  "styles": [{ "start": 6, "end": 11, "style": "bold" }],
  "links": [{ "start": 18, "end": 22, "href": "https://docs.openclaw.ai" }]
}

​

表格处理

channels:
  discord:
    markdown:
      tables: code
    accounts:
      work:
        markdown:
          tables: off

​

分块规则

• 分块限制来自通道适配器/配置，并适用于 IR 文本，而不是 渲染后的输出。
• 围栏代码块会作为一个整体保留，并在末尾附加一个换行符，以便 各通道能够正确渲染结束围栏。
• 列表和引用前缀是 IR 文本的一部分，因此分块时不会在前缀中间 进行拆分。
• 行内样式不会跨块拆分；渲染器会在下一块的开头重新打开已开启的 样式。

​

链接策略

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

​

剧透

​

可折叠详情

​

添加或更新通道格式化器

1. 解析一次，使用 markdownToIR(...)，并传入与通道相适配的 选项（autolink、headingStyle、blockquotePrefix、tableMode）。
2. 使用样式标记映射（或 对于像 Signal 这样的传输方式使用自定义样式范围逻辑）通过 renderMarkdownWithMarkers(...) 进行渲染。
3. 在渲染每个块之前，使用 chunkMarkdownIR(...) 或 renderMarkdownIRChunksWithinLimit(...) 进行分块。
4. 连接适配器，从 出站发送路径中调用新的分块器和渲染器。
5. 用格式测试以及通道进行分块时的出站投递测试进行测试。

​

常见陷阱

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

​

相关内容