lark-markdown

A Markdown file that lives in Feishu's cloud storage and stays an ordinary text file there — this puts one up, reads it back, and changes it in place.

WHEN TO USE

SCOPE

USE FOR

Upload a Markdown file from your computer into Feishu's cloud storage.
Read the current contents of a Markdown file stored in Drive.
Replace one piece of text in a Markdown file without retyping the whole thing.
Compare a Markdown file's two remote versions, or a remote version against your local draft.
Overwrite a Markdown file's entire content with a new version.

NOT FOR

Does not import a Markdown file into an online Feishu doc (docx); that's lark-drive.
Does not search, share, comment on, move, or delete files; that's lark-drive.
Does not operate on a Markdown file that lives only on your local disk.

This is a saved copy of the skill's SKILL.md instructions. It may differ from the upstream file or the version you install.

In this document (5)

markdown (v1)

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../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-cli drive +version-history
用户要把本地 Markdown 导入成在线新版文档（docx），不要用本 skill，改用 lark-drive 的 lark-cli drive +import --type docx
用户要对 Markdown 文件做rename / move / delete / 搜索 / 权限 / 评论等云空间（云盘/云存储）操作，不要留在本 skill，切到 lark-drive
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`	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 等

Account or credentials required

1 FOR THE AGENT

01
Read the lark-shared setup guide before running any command
Before running any lark-markdown command, read skills/lark-markdown/lark-shared/SKILL.md — it documents the authentication and permission handling this skill depends on.

Listed as free: Connected services may require an account or charge fees.

Not standalone. This skill ships with larksuite/cli and only works together with that tool — install the tool first, then add this skill.

Run this outside your AI tool, using Node.js 22.20.0 or newer. Skills CLI 1.7.2 skips skill selection; prompts cancel installation without an interactive terminal. If choosing Project when asked about installation scope, open your project's folder before running this.

Install checklist

Check selected tools if a picker appears; Claude Code may be unchecked under Additional agents. ↑/↓ moves, Space toggles selections, Enter confirms.
Without a tool picker, check Installing to: for your intended tool. Stop if it names a different tool.
If asked, choose Symlink (Recommended) for shared files or Copy to all agents for separate copies; review the summary before confirming installation.
Install the find-skills skill? defaults to Yes, adding another skill for all projects. Choose No if you don't want that extra installation.

Skills CLI 1.7.2 sends install data to skills.sh by default, including the source, skill names, target tools and file details; GitHub sources are reported only when GitHub confirms the repository is public, while other remote sources can also be reported. Confirmed-public GitHub sources also trigger a security-audit request. Before installing, set the environment variable DO_NOT_TRACK=1 or DISABLE_TELEMETRY=1 to disable both.

npx skills add larksuite/cli --skill lark-markdown lark-base lark-doc lark-drive lark-shared lark-sheets lark-whiteboard lark-wiki --full-depth

It installs 8 skills: this one and the 7 it relies on, listed below. Once these skills are installed where Claude Code loads them, their descriptions help Claude decide when to use them.

What's inside

Files included with this skill.

View on GitHub

The repository is licensed under MIT — use, modification, and redistribution are allowed under that license’s terms.

View the repository’s license file on GitHub →

markdown (v1)

快速决策

核心边界

Shortcuts（推荐优先使用）

参考

Account or credentials required

What's inside

More skills

lark-approval

lark-apps

lark-attendance

lark-base

lark-calendar

lark-contact