<< All versions
Skill v1.2.0
currentAutomated scan96/100larksuite/cli/lark-markdown
~1 modified, -6 removed
──Details
PublishedMay 20, 2026 at 11:33 AM
Content Hashsha256:27ea810b2f5f424c...
Git SHAc98a49f2a3e9
Bump Typepatch
──Files
Files (1 file, 3.2 KB)
SKILL.md3.2 KBactive
SKILL.md · 56 lines · 3.2 KB
name: lark-markdown version: 1.2.0 description: "飞书 Markdown:查看、创建、上传、编辑和比较 Markdown 文件。当用户需要创建或编辑 Markdown 文件、读取、修改、局部 patch 或比较差异时使用。" metadata: requires: bins: ["lark-cli"] cliHelp: "lark-cli markdown --help"
markdown (v1)
CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md),其中包含认证、权限处理
快速决策
- 用户要上传、创建一个原生 `.md` 文件,使用
lark-cli markdown +create - 用户要比较原生 `.md` 文件的历史版本差异,或比较远端 Markdown 与本地草稿,使用
lark-cli markdown +diff - 用户要读取 Drive 里某个 `.md` 文件内容,使用
lark-cli markdown +fetch - 用户要对 Markdown 文件做局部文本替换 / 正则替换,优先使用
lark-cli markdown +patch - 用户要覆盖更新 Drive 里某个 `.md` 文件内容,使用
lark-cli markdown +overwrite - 用户要先拿 Markdown 文件的历史版本号,再做比较/下载/回滚,先用 `lark-drive` 的
lark-cli drive +version-history - 用户要把本地 Markdown 导入成在线新版文档(docx),不要用本 skill,改用 `lark-drive` 的
lark-cli drive +import --type docx - 用户要对 Markdown 文件做rename / move / delete / 搜索 / 权限 / 评论等云空间操作,不要留在本 skill,切到 `lark-drive`
核心边界
- 本 skill 处理的是 Drive 中作为普通文件存储的 Markdown,不是 docx 文档
--name和本地--file文件名都必须显式带.md后缀;不满足时 shortcut 会直接报错--content支持:- 直接传字符串
@file从本地文件读取内容-从 stdin 读取内容markdown +patch的内部语义是:先完整下载 Markdown,再本地替换,再整文件覆盖上传markdown +patch不是服务端原子 patch;它是 CLI 侧编排出来的局部更新能力markdown +patch当前只支持单组--pattern/--contentmarkdown +patch替换后的最终内容不能为空;如果替换后整篇 Markdown 变成空字符串,CLI 会直接报错,不会上传空文件--file只接受本地.md文件路径
Shortcuts(推荐优先使用)
Shortcut 是对常用操作的高级封装(lark-cli markdown +<verb> [flags])。有 Shortcut 的操作优先使用。
| Shortcut | 说明 | |
|---|---|---|
| `+create` | Create a Markdown file in Drive | |
| `+diff` | Compare two remote Markdown versions, or compare remote Markdown against a local file | |
| `+fetch` | Fetch a Markdown file from Drive | |
| `+patch` | Patch a Markdown file in Drive via fetch-local-replace-overwrite | |
| `+overwrite` | Overwrite an existing Markdown file in Drive |
参考
- lark-shared — 认证和全局参数
- lark-drive — Drive 文件管理、导入 docx、move/delete/search 等