‹ 首页

lark-markdown

@larksuite · 收录于 1 周前 · 上游提交 今天

飞书 Markdown：查看、创建、上传、编辑和比较 Markdown 文件。当用户需要创建或编辑 Markdown 文件、读取、修改、局部 patch 或比较差异时使用。不负责将 Markdown 导入为飞书在线文档，也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

场景文档编写文件编辑内容对比

适合你，如果经常需要处理 Markdown 格式的文档

/ 下载安装
lark-markdown.skill双击,或拖进 Claude 桌面版 / Cowork,即完成安装↓ .skill↓ .zip
用别的 agent?下载 .zip 解压,把文件夹放进它的技能目录
Claude Code~/.claude/skills/(项目级 .claude/skills/)
Codex CLI~/.codex/skills/
Cursor自动读取上面两处目录
其他工具见其文档的「skills」目录;两个下载是同一份文件,只是名字不同
/ 通过 npx 安装 校验哈希
npx oh-my-skill add larksuite/cli/lark-markdown
/ 通过 bash 安装
curl -fsSL https://oh-my-skill.com/install.sh | bash -s -- larksuite/cli/lark-markdown
/ 已经装过?验证本机副本,不用重装
npx oh-my-skill verify larksuite/cli/lark-markdown
安装目标可用 --agent / --scope 或 --to 明确指定;省略时只会在唯一已存在的 agent 目录上自动选择,零命中或多命中会停止并提示。content_hash 缺失或不一致均拒装。
–GitHub stars
~1.4K最小装载
~6.7K含声明引用
~6.7K文本包总量
镜像托管

怎么用

技能原文 SKILL.md作者撰写 · MIT · baf6050

markdown (v1)

CRITICAL — 开始前 MUST 先用 Read 工具读取 [../lark-shared/SKILL.md](../lark-shared/SKILL.md)，其中包含认证、权限处理

快速决策
  • 身份：Markdown 文件通常属于用户云空间资源，优先使用 --as user。如为自动化场景，或应用已创建并持有目标文件权限，可按场景使用 --as bot。首次以 user 身份访问前执行 lark-cli auth login
  • markdown +create / +overwrite 失败时，先判断是不是身份和权限问题：bot 更常见的是 app scope 或目标目录 ACL，user 更常见的是用户授权或用户 ACL；不要不加判断地来回切身份重试。
  • 用户要上传、创建一个原生 .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-drive/SKILL.md) 的 lark-cli drive +version-history
  • 用户要把本地 Markdown 导入成在线新版文档（docx），不要用本 skill，改用 [lark-drive](../lark-drive/SKILL.md) 的 lark-cli drive +import --type docx
  • 用户要对 Markdown 文件做rename / move / delete / 搜索 / 权限 / 评论等云空间（云盘/云存储）操作，不要留在本 skill，切到 [lark-drive](../lark-drive/SKILL.md)
  • markdown +create / +overwrite 命中 missing scope、permission denied、not found、quota_exceeded、version limit 时，默认停止重试并按报错 hint 处理；只有 rate_limit、server_error 或临时网络错误才做有限退避重试。
  • markdown +create 的目标参数不要猜：Drive 文件夹用 --folder-token，Wiki 节点用 --wiki-token。如果用户给的是 URL，可以直接传完整 URL；CLI 会归一成 token。不要把 doc/sheet/wiki URL 放进 --folder-token 试错。
核心边界
  • 本 skill 处理的是 Drive 中作为普通文件存储的 Markdown，不是 docx 文档
  • --name 和本地 --file 文件名都必须显式带 .md 后缀；不满足时 shortcut 会直接报错
  • --content 支持：
  • 直接传字符串
  • @file 从本地文件读取内容
  • - 从 stdin 读取内容
  • markdown +patch 的内部语义是：先完整下载 Markdown，再本地替换，再整文件覆盖上传
  • markdown +patch 不是服务端原子 patch；它是 CLI 侧编排出来的局部更新能力
  • markdown +patch 当前只支持单组 --pattern / --content
  • markdown +patch 替换后的最终内容不能为空；CLI 会拒绝上传空文件，因为 Drive 不支持零字节 Markdown，且空文件通常是误操作
  • --file 只接受本地 .md 文件路径

正则替换时要特别注意 --pattern 的转义：

# BAD: 未转义正则特殊字符，可能匹配到错误位置
lark-cli markdown +patch --file-token boxcnxxxx --regex --pattern "version (1.0)" --content "version (2.0)"

# GOOD: 显式转义括号和点号
lark-cli markdown +patch --file-token boxcnxxxx --regex --pattern "version \\(1\\.0\\)" --content "version (2.0)"
Shortcuts（推荐优先使用）

Shortcut 是对常用操作的高级封装（lark-cli markdown +<verb> [flags]）。有 Shortcut 的操作优先使用。

| Shortcut | 说明 | |----------|------| | [+create](references/lark-markdown-create.md) | Create a Markdown file in Drive | | [+diff](references/lark-markdown-diff.md) | Compare two remote Markdown versions, or compare remote Markdown against a local file | | [+fetch](references/lark-markdown-fetch.md) | Fetch a Markdown file from Drive | | [+patch](references/lark-markdown-patch.md) | Patch a Markdown file in Drive via fetch-local-replace-overwrite | | [+overwrite](references/lark-markdown-overwrite.md) | Overwrite an existing Markdown file in Drive |

参考
  • [lark-shared](../lark-shared/SKILL.md) — 认证和全局参数
  • [lark-drive](../lark-drive/SKILL.md) — Drive 文件管理、导入 docx、move/delete/search 等
按 MIT 许可原样转载,未经改动 · 在 GitHub 查看 →

评论

登录即可评论;带「已验证安装」的,是发布者名下有本店的安装或持有记录。
…