From 9cbf8d75e63dd7de0d7c7248d0e7172397b0707d Mon Sep 17 00:00:00 2001 From: OwenYWT Date: Wed, 8 Apr 2026 10:41:25 +0800 Subject: [PATCH 1/2] docs(lark-doc): clarify when markdown escaping is needed --- skills/lark-doc/references/lark-doc-create.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/skills/lark-doc/references/lark-doc-create.md b/skills/lark-doc/references/lark-doc-create.md index b26a162fb..99f51c01b 100644 --- a/skills/lark-doc/references/lark-doc-create.md +++ b/skills/lark-doc/references/lark-doc-create.md @@ -120,7 +120,8 @@ lark-cli docs +create --title "产品需求" --markdown ' { } | ^` +- 只有当字符会被解释为 Markdown / Lark 富文本语法时，才需要使用反斜杠转义：`* ~ ` $ [ ] < > { } | ^` +- 普通文本中的孤立字符不要过度转义。例如 `5 * 3`、`version~1.0`、`final_trajectory` 通常应保持原样，只有像 `*斜体*`、`**粗体**`、`~~删除线~~` 这种会触发格式化的写法，想按字面量显示时才需要转义 --- @@ -642,7 +643,7 @@ $$ ## 最佳实践 - **空行分隔**：不同块类型之间用空行分隔 -- **转义字符**：特殊字符用 `\` 转义：`\*` `\~` `\`` +- **转义字符**：只有在字符会触发格式化时才用 `\` 转义。例如想输出字面量 `*斜体*` 时写成 `\*斜体\*`；但 `5 * 3`、`version~1.0`、`final_trajectory` 这类普通文本通常不需要转义 - **图片**：使用 URL，系统自动下载上传 - **分栏**：列宽总和必须为 100 - **表格选择**：简单数据用 Markdown，复杂嵌套用 `` From 5881729f7d644b61b8f54612c610e88d5854bd2d Mon Sep 17 00:00:00 2001 From: OwenYWT Date: Wed, 8 Apr 2026 15:53:33 +0800 Subject: [PATCH 2/2] docs(lark-doc): fix escaped special character code span --- skills/lark-doc/references/lark-doc-create.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/lark-doc/references/lark-doc-create.md b/skills/lark-doc/references/lark-doc-create.md index 99f51c01b..c6828069e 100644 --- a/skills/lark-doc/references/lark-doc-create.md +++ b/skills/lark-doc/references/lark-doc-create.md @@ -120,7 +120,7 @@ lark-cli docs +create --title "产品需求" --markdown ' { } | ^` +- 只有当字符会被解释为 Markdown / Lark 富文本语法时，才需要使用反斜杠转义：``* ~ ` $ [ ] < > { } | ^`` - 普通文本中的孤立字符不要过度转义。例如 `5 * 3`、`version~1.0`、`final_trajectory` 通常应保持原样，只有像 `*斜体*`、`**粗体**`、`~~删除线~~` 这种会触发格式化的写法，想按字面量显示时才需要转义 ---