lark-markdown
bylarksuite· 47 skills
飞书 Markdown：查看、创建、上传、编辑和比较 Markdown 文件。当用户需要创建或编辑 Markdown 文件、读取、修改、局部 patch 或比较差异时使用。不负责将 Markdown 导入为飞书在线文档，也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
How to install lark-markdown?
larksuite/cli/lark-markdown
$npx -y skills add larksuite/cli --skill lark-markdownInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Run `npx skills use "https://github.com/larksuite/cli" --skill "larksuite/cli/lark-markdown"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Use the skills in "https://github.com/larksuite/cli" that are relevant to the current task. Run `npx skills add "https://github.com/larksuite/cli"` and select the relevant skills, then follow their instructions.
SKILL.md
| 1 | # markdown (v1) |
| 2 | |
| 3 | **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理** |
| 4 | |
| 5 | ## 快速决策 |
| 6 | |
| 7 | - 身份：Markdown 文件通常属于用户云空间资源，优先使用 `--as user`。如为自动化场景，或应用已创建并持有目标文件权限，可按场景使用 `--as bot`。首次以 `user` 身份访问前执行 `lark-cli auth login` |
| 8 | - `markdown +create` / `+overwrite` 失败时，先判断是不是身份和权限问题：`bot` 更常见的是 app scope 或目标目录 ACL，`user` 更常见的是用户授权或用户 ACL；不要不加判断地来回切身份重试。 |
| 9 | |
| 10 | - 用户要**上传、创建一个原生 `.md` 文件**，使用 `lark-cli markdown +create` |
| 11 | - 用户要**比较原生 `.md` 文件的历史版本差异**，或比较远端 Markdown 与本地草稿，使用 `lark-cli markdown +diff` |
| 12 | - 用户要**读取 Drive 里某个 `.md` 文件内容**，使用 `lark-cli markdown +fetch` |
| 13 | - 用户要对 Markdown 文件做**局部文本替换 / 正则替换**，优先使用 `lark-cli markdown +patch` |
| 14 | - 用户要**覆盖更新 Drive 里某个 `.md` 文件内容**，使用 `lark-cli markdown +overwrite` |
| 15 | - 用户要先拿 Markdown 文件的历史版本号，再做比较/下载/回滚，先用 [`lark-drive`](../lark-drive/SKILL.md) 的 `lark-cli drive +version-history` |
| 16 | - 用户要把本地 Markdown **导入成在线新版文档（docx）**，不要用本 skill，改用 [`lark-drive`](../lark-drive/SKILL.md) 的 `lark-cli drive +import --type docx` |
| 17 | - 用户要对 Markdown 文件做**rename / move / delete / 搜索 / 权限 / 评论**等云空间（云盘/云存储）操作，不要留在本 skill，切到 [`lark-drive`](../lark-drive/SKILL.md) |
| 18 | - `markdown +create` / `+overwrite` 命中 `missing scope`、`permission denied`、`not found`、`quota_exceeded`、`version limit` 时，默认停止重试并按报错 hint 处理；只有 `rate_limit`、`server_error` 或临时网络错误才做有限退避重试。 |
| 19 | - `markdown +create` 的目标参数不要猜：Drive 文件夹用 `--folder-token`，Wiki 节点用 `--wiki-token`。如果用户给的是 URL，可以直接传完整 URL；CLI 会归一成 token。不要把 doc/sheet/wiki URL 放进 `--folder-token` 试错。 |
| 20 | |
| 21 | ## 核心边界 |
| 22 | |
| 23 | - 本 skill 处理的是 **Drive 中作为普通文件存储的 Markdown**，不是 docx 文档 |
| 24 | - `--name` 和本地 `--file` 文件名都必须显式带 `.md` 后缀；不满足时 shortcut 会直接报错 |
| 25 | - `--content` 支持： |
| 26 | - 直接传字符串 |
| 27 | - `@file` 从本地文件读取内容 |
| 28 | - `-` 从 stdin 读取内容 |
| 29 | - `markdown +patch` 的内部语义是：**先完整下载 Markdown，再本地替换，再整文件覆盖上传** |
| 30 | - `markdown +patch` 不是服务端原子 patch；它是 CLI 侧编排出来的局部更新能力 |
| 31 | - `markdown +patch` 当前只支持**单组** `--pattern` / `--content` |
| 32 | - `markdown +patch` 替换后的最终内容**不能为空**；CLI 会拒绝上传空文件，因为 Drive 不支持零字节 Markdown，且空文件通常是误操作 |
| 33 | - `--file` 只接受本地 `.md` 文件路径 |
| 34 | |
| 35 | 正则替换时要特别注意 `--pattern` 的转义： |
| 36 | |
| 37 | ```bash |
| 38 | # BAD: 未转义正则特殊字符，可能匹配到错误位置 |
| 39 | lark-cli markdown +patch --file-token boxcnxxxx --regex --pattern "version (1.0)" --content "version (2.0)" |
| 40 | |
| 41 | # GOOD: 显式转义括号和点号 |
| 42 | lark-cli markdown +patch --file-token boxcnxxxx --regex --pattern "version \\(1\\.0\\)" --content "version (2.0)" |
| 43 | ``` |
| 44 | |
| 45 | ## Shortcuts（推荐优先使用） |
| 46 | |
| 47 | Shortcut 是对常用操作的高级封装（`lark-cli markdown +<verb> [flags]`）。有 Shortcut 的操作优先使用。 |
| 48 | |
| 49 | | Shortcut | 说明 | |
| 50 | |----------|------| |
| 51 | | [`+create`](references/lark-markdown-create.md) | Create a Markdown file in Drive | |
| 52 | | [`+diff`](references/lark-markdown-diff.md) | Compare two remote Markdown versions, or compare remote Markdown against a local file | |
| 53 | | [`+fetch`](references/lark-markdown-fetch.md) | Fetch a Markdown file from Drive | |
| 54 | | [`+patch`](references/lark-markdown-patch.md) | Patch a Markdown file in Drive via fetch-local-replace-overwrite | |
| 55 | | [`+overwrite`](references/lark-markdown-overwrite.md) | Overwrite an existing Markdown file in Drive | |
| 56 | |
| 57 | ## 参考 |
| 58 | |
| 59 | - [lark-shared](../lark-shared/SKILL.md) — 认证和全局参数 |
| 60 | - [lark-drive](../lark-drive/SKILL.md) — Drive 文件管理、导入 docx、move/delete/search 等 |
Related
6 picksType
- lark-base飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、workflow、角色权限；遇到 Base/多维表格/bitable 或 /base/ 链接时使用。文件导入转 lark-drive，认证/授权转 lark-shared。Jul 2026
- lark-drive飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入…Jul 2026
- lark-sheets飞书电子表格：创建和操作电子表格。支持创建表格、管理工作表与行列结构（增删/合并/调整尺寸/隐藏/冻结）、读写单元格（值/公式/样式/批注/单元格图片）、查找替换、多操作原子批量更新，以及图表、透视表、条件格式、筛选器、迷你图、浮动图片等对象的创建与维护。当用户需要创建电子表格、管理工作表、批量读写或编辑数据、统计汇…Jul 2026
- lark-mail飞书邮箱：Use when user mentions 起草邮件、写邮件、草稿、发送/回复/转发邮件、查阅邮件、看邮件、搜索邮件、邮件文件夹、邮件标签、邮件联系人、监听新邮件、邮件收信规则等；use for mail/email intent only.Jul 2026
- lark-slides飞书幻灯片：创建和编辑幻灯片。创建演示文稿、读取幻灯片内容、管理幻灯片页面（创建、删除、读取、局部替换）。当用户需要创建或编辑幻灯片、读取或修改单个页面时使用。当用户给出 doubao.com 的 /slides/ URL/token 时，也应直接使用本 skill，不要因为域名不是飞书而回退到…Jul 2026
- pptxUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both.Jul 2026
