feishu2md 完整攻略：把飞书文档一键转成 Markdown，最快 60 秒

feishu2md 完整攻略：把飞书文档一键转成 Markdown，最快 60 秒

【免费下载链接】feishu2md一键命令下载飞书文档为 Markdown（寻找维护者）项目地址: https://gitcode.com/gh_mirrors/fe/feishu2md

下午五点半，你刚整理完一份 20 页的飞书文档，领导却要 Markdown 版。于是复制、粘贴、调表格、一张张存图，一小时过去表格还是裂的。这种"复制地狱"，feishu2md 一条命令就终结：飞书文档整篇变 Markdown，图片自动下载、表格原样保留。

feishu2md 是一个用 Go 写的开源命令行工具，核心用法一句话就能说清：粘贴飞书文档链接，回车，得到一份干净可用的 Markdown 文件。你不需要会写代码，跟着下面的步骤走就行。

60 秒上手：先跑通一条命令再说 🚀

别担心，从零到跑通只需要两步：拿凭证、跑命令。

第一步：拿到 App ID 和 App Secret

去飞书开放平台创建一个"企业自建应用"，开通 4 个只读权限（docx:document:readonly 读取文档、docs:document.media:download 下载图片、drive:file:readonly 查看云空间文件、wiki:wiki:readonly 查看知识库），然后在"凭证与基础信息"里就能看到 App ID 和 App Secret。全程不到 5 分钟。

第二步：配置并转换

把下面两行命令里的占位符换成你自己的信息：

feishu2md config --appId 你的AppID --appSecret 你的AppSecret feishu2md dl "https://你的团队.feishu.cn/docx/文档token"

文档链接怎么拿？在飞书文档右上角点"分享 → 开启链接分享 → 复制链接"，粘进命令就行。看到这行输出，说明已经成功了：

Downloaded markdown file to /当前目录/文档token.md

就这么简单。转完的 .md 文件可以直接打开，图片已经自动躺在static/目录里等着你了。

工具一共就 3 个核心命令，全部列在下面这张表里：

三个进阶玩法：定时同步、Web 界面、自定义配置 ✨

玩法一：定时任务自动同步

把转换交给系统定时器，每天凌晨自动把飞书文件夹同步到服务器或 Git 仓库：

0 2 * * * feishu2md dl --batch -o /srv/docs "https://你的团队.feishu.cn/drive/folder/文件夹token"

适合场景：文档站点、知识库需要"每天自动更新"，你只管写内容，同步交给机器。

玩法二：Web 界面转换

不想装命令行？用 Docker 一行起一个网页版，浏览器里粘贴链接就能转换：

docker run -it --rm -p 8080:8080 \ -e FEISHU_APP_ID=你的AppID \ -e FEISHU_APP_SECRET=你的AppSecret \ wwwsine/feishu2md

然后打开http://localhost:8080，把文档链接粘进去即可。适合场景：给不会命令行的同事用，或者你只想偶尔转一两篇、懒得敲命令。

玩法三：自定义输出配置

工具会在系统用户目录下生成配置文件feishu2md/config.json，手动改几个字段就能定制输出：

{ "feishu": { "app_id": "你的AppID", "app_secret": "你的AppSecret" }, "output": { "image_dir": "images", "title_as_filename": true, "use_html_tags": false, "skip_img_download": false } }

• image_dir：图片统一存到哪个目录，默认static
• title_as_filename：用文档标题命名文件，而不是一串看不懂的 token
• skip_img_download：设为 true 时只保留原图链接、不下载图片

适合场景：批量归档时统一图片目录、让文件名可读，方便后续入库和检索。

三个人的真实变化：以前 vs 现在 👥

运维工程师阿凯：以前每次发版前，要把飞书上的变更记录手动整理成 Markdown 贴进发布文档，一次至少 20 分钟；现在配好定时任务，发布前 3 秒拉最新版本，直接提交。

产品经理小鹿：以前写周报要手动汇总 3 个文档，复制表格总错位，气得想摔键盘；现在一条--batch命令把整个文件夹拉下来，表格原样保留，拼进周报收工。

自由职业者老周：以前每做完一个项目，飞书笔记里的图要一张张另存，再手动贴进博客；现在一条命令连文带图打包成 Markdown，提交归档，干净利落。

新手最容易踩的 3 个坑 💡

Q：App ID 配好了，还是报权限错误？

A：别急着怀疑命令，按顺序排查：① 应用是否已经发布（看开发者后台的"版本管理与发布"）；② 4 个只读权限是否都开了；③ 文档链接是否开启了"互联网上获得链接的人可阅读"。另外权限改动不是秒生效，等一两分钟再试。

Q：转换完图片是空的，只有链接？

A：先看配置文件里skip_img_download是不是被设成了 true；再确认应用有没有docs:document.media:download权限。如果怀疑是接口层的问题，可以加--dump参数把原始 JSON 导出来，一眼就能看出是哪一步断了。

Q：批量转换文件夹，为什么只转了一部分？

A：文件夹里混有旧版文档（docs 类型）时会被主动跳过，这是设计如此。另外请确认用的是"分享"出来的链接，而不是浏览器地址栏里带个人参数的链接，否则可能只能看到你自己的部分文件。

想深入了解？资源都给你列好了 📚

• 完整使用文档与权限说明：README
• 核心转换逻辑（URL 解析、API 调用、内容解析）：core/ 和 utils/
• 命令行入口与 Web 服务源码：cmd/ 和 web/
• 官方转换示例与测试数据：testdata/

项目是开源的，目前正在寻找社区维护者。遇到问题可以直接在仓库提交 Issue，想贡献代码就发 PR，表现好的维护者还有机会成为主协调员。

写在最后 ✍️

以前，文档搬运靠复制粘贴，格式靠手工救；现在，一条命令就是整条流水线。别让表格错位和图片另存再浪费你的周末了——克隆 feishu2md，把链接粘进去，60 秒后你就拥有一个干净利落的 Markdown 文件。

git clone https://gitcode.com/gh_mirrors/fe/feishu2md

现在就去试试吧，你的第一篇飞书转 Markdown，就差这一条命令的距离。🚀

【免费下载链接】feishu2md一键命令下载飞书文档为 Markdown（寻找维护者）项目地址: https://gitcode.com/gh_mirrors/fe/feishu2md