Markdown 格式

OpenClaw 會先將輸出 Markdown 轉換成共用的中介表示 (IR)，再轉譯為各頻道專用輸出。IR 會保留純文字以及 樣式/連結 span，因此一次解析步驟即可供所有頻道使用，且分段永遠不會 在 span 中途拆開格式。

​

管線

1. 將 Markdown 解析為 IR (markdownToIR) - 純文字加上樣式 span （粗體、斜體、刪除線、程式碼、程式碼區塊、劇透、引用區塊、 標題 1-6）與連結 span。偏移量使用 UTF-16 code units，因此 Signal 樣式 範圍可直接與其 API 對齊。只有在頻道選擇表格模式時，才會解析表格。
2. 分段 IR (chunkMarkdownIR / renderMarkdownIRChunksWithinLimit)
   • 拆分會在轉譯前對 IR 文字進行，因此行內樣式與 連結會依每個分段切片，而不是跨越邊界而斷裂。
3. 依頻道轉譯 (renderMarkdownWithMarkers) - 樣式標記對應表 會將 span 轉成該頻道的原生標記。

​

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。

​

劇透

劇透標記 (||spoiler||) 會為 Signal（對應到 SPOILER 樣式範圍）與 Telegram（對應到 <tg-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 偏移量，而不是 code point 偏移量。
• 保留圍欄程式碼區塊的結尾換行，讓結束標記 落在自己的行上。

​

相關內容