feishu-cli-markdown
Installation
SKILL.md
飞书云盘原生 Markdown（markdown create/fetch/overwrite/diff）
markdown 命令组把 Drive 上的 .md 当作普通文件整体读写，保留原始 Markdown 源码，不做 Markdown ↔ 飞书 docx 块的转换。
feishu-cli：如尚未安装，请前往 riba2534/feishu-cli 获取安装方式。
核心概念：与 doc import / doc export 的区别
| 命令 | 行为 | 创建出的类型 | 适用场景 |
|---|---|---|---|
doc import |
Markdown → 飞书 docx 块（标题/列表/表格/Callout/Mermaid 画板…） | docx（在线协同文档） | 给人读、要排版、要团队评论 |
doc export |
docx → Markdown（块解析回 markdown 源码） | 本地 .md |
从飞书 docx 落盘到 Git |
markdown create/fetch/overwrite |
把 .md 整体上传/下载，不转换 |
file（Drive 普通文件） | AI agent 直接落盘原汁原味 .md、保留 fenced code block 缩进、当图床/密集代码块/版本管理用 |
判断走哪条：
- 想要飞书 docx 渲染（人读、排版、表格分块、画板渲染）→
doc import - 想要原始
.md文本 unchanged 保留在云盘（AI agent 读回完全一致；docx 块解析有损）→markdown create - 想反复覆盖同一份
.md、保持 file_token 不变（分享链接持久）→markdown overwrite