SKILL 飞书云文档和本地Markdown互转

本文由AI创作

技能用途

实现飞书云文档和本地Markdown的互相转换支持常见的markdown各种语法

支持的格式超级全：

• ✅ 标题层级（H1-H6）
• ✅ 无序/有序列表
• ✅ 引用块
• ✅ Callout 提示块（自动适配飞书格式）
• ✅ 代码块（带语言高亮）
• ✅ 图片（自动上传/下载）
• ✅ 链接
• ✅ 表格
• ✅ 分割线

🚀 怎么使用？

第一步：安装技能

bash
npx skills add https://github.com/steelan9199/wechat-publisher/tree/main/skills/feishu-docx
第二步：配置飞书凭证
在技能目录下找到 config.default.json，填入你的飞书应用凭证：
json
{  "appId": "your_app_id",  "appSecret": "your_app_secret"}
第三步：开始使用！
只需要对 AI 说：




“帮我把这篇文章上传到飞书文档”




或者




“把这个飞书文档下载成 Markdown”




AI 会自动调用技能完成转换，你什么都不用管！
═════════
💡 适合谁用？



人群
使用场景




技术博主
本地写技术文章，一键同步到团队飞书


产品经理
写 PRD 文档，方便团队协作


运营同学
整理活动方案，快速共享给团队


知识管理党
本地 Markdown 库和飞书双向同步



═════════
技能使用例子
上传本地的markdown文档
用户提示词




把文件上传到飞书云文档测试文档.md




AI使用技能

生成的飞书云文档
https://kr0lqjlbmo.feishu.cn/docx/HJeddWJQgoL4FXxzZPxcx0ronyg

═════════
下载飞书云文档到本地markdown
用户提示词




下载飞书云文档 https://kr0lqjlbmo.feishu.cn/docx/HJeddWJQgoL4FXxzZPxcx0ronyg




AI使用技能

文档中的图片和文本都下载了

支持自定义标题的颜色H1到H6
如果不知道哪些颜色可以使用, 就直接问AI

前6种颜色, 分别设置为H1到H6的标题颜色




把文件上传到飞书云文档测试文档.md前6种颜色, 分别设置为H1到H6的标题颜色






粗体斜体, 以及粗斜体的颜色, 同样支持

═════════
callout （也叫提示块/高亮块）






文档所有权的转移
本技能是通过飞书企业自建应用创建的飞书云文档,文档所有权归企业自建应用,
因此在代码中添加了转移文档所有权的代码,这样, 用户就和应用有了同等的文档权限.
本地markdown上传到飞书云文档后, 云文档助手会收到所有权转移的提示消息

本地markdown上传到飞书云文档, 再下载下来和源文档一致吗
基本一致
图片的格式支持什么路径

相对路径
绝对路径

text
- ![图片描述](戴珍珠耳环的女人.png)- ![图片描述](D:\code-test\旋涡.png)
下载的图片在哪里
和下载的markdown文件在同一个文件夹下
下载的markdown文件在哪里
默认在当前工作目录的这个文件夹里
text
飞书云文档下载
有时候AI会创建到技能feishu-docx的目录里,文件夹的名字, 同样也是飞书云文档下载
可以指定下载到某个文件夹吗?
可以




下载你刚才创建的飞书云文档, 下载到aaabbbccc文件夹.





重复下载同一个文档, 会覆盖之前下载的文档吗
不会
会新建一个文档标题的文件夹, 标题后面添加时间


下载的响应JSON数据
json
{  "code": 0,  "msg": "飞书文档下载成功",  "data": {    "document_id": "IRgAdSmpXoEGI8xb7ajcefKQnEe",    "document_title": "Markdown 元素综合测试文档",    "document_folder_path": "D:\\code-test\\aaabbbccc\\Markdown 元素综合测试文档_2026_03_19_04_11_29",    "markdown_file_path": "D:\\code-test\\aaabbbccc\\Markdown 元素综合测试文档_2026_03_19_04_11_29\\Markdown 元素综合测试文档.md",    "blocks_count": 120,    "images_downloaded": 0  }}
扣子智能体教程
https://space.bilibili.com/26079586