飞书文档转 Markdown 完整指南一个命令解决手动复制粘贴的烦恼【免费下载链接】feishu2md一键命令下载飞书文档为 Markdown寻找维护者项目地址: https://gitcode.com/gh_mirrors/fe/feishu2md你有没有经历过这样的时刻飞书文档里写了一下午的方案要发到公司 Wiki 或自己的博客却发现飞书只支持导出 Word 和 PDF就是不给 Markdown。于是你复制、粘贴、调格式、手动下载每一张图片……半小时过去了格式还是乱的。其实这个问题早就有了解法——开源工具 feishu2md 能用一行命令把飞书文档转 Markdown而且是原生的、干净的、带图片的 Markdown。它是什么和手动操作差在哪feishu2md 是一个用 Go 语言编写的命令行工具核心逻辑只有一句话读取飞书文档链接调用飞书开放平台的 API 拿到文档结构再解析成标准 Markdown 文件。它和你手动复制粘贴的差别用一张表就能说清对比项手动复制粘贴feishu2md耗时一篇大文档半小时起几秒到几十秒图片24 小时临时链接要逐个下载自动下载到本地并改写引用路径表格粘贴后经常错位按 Markdown 表格语法完整保留代码块语言高亮丢失自动识别几十种编程语言批量文档只能一篇篇来文件夹、知识库一键全量转换先来做环境准备feishu2md 依赖 Go 语言生态但好消息是你不需要自己装 Go——项目在 Release 里提供了 Windows、Linux、macOS 三个平台的预编译可执行文件下载后放到 PATH 路径里即可。想从源码构建也可以在项目根目录执行make build产物会生成在当前目录下的feishu2md可执行文件。装好后运行feishu2md -h能看到config和download别名dl两个子命令就说明安装成功了。三步跑通第一次转换第一步拿到 API 凭证feishu2md 通过飞书开放平台调用文档接口所以你需要先创建一个应用进入飞书开发者后台创建一个企业自建应用信息随意填不必等审核通过在权限管理里开通几个必要的只读权限docx:document:readonly读取新版文档、docs:document.media:download下载图片附件、drive:file:readonly查看云空间文件、wiki:wiki:readonly查看知识库回到凭证与基础信息页面复制 App ID 和 App Secret第二步写入配置执行下面这行命令工具会自动生成配置文件并填入凭证feishu2md config --appId 你的AppID --appSecret 你的AppSecret配置文件默认生成在~/.config/feishu2md/config.jsonWindows 在%AppData%下里面除了凭证还有几个后续会用到的输出选项image_dir控制图片存放文件夹名title_as_filename决定是否用文档标题当文件名use_html_tags控制复杂格式是否用 HTML 标签兜底。第三步转换你的第一个文档先把飞书文档的链接分享出来在文档右上角点分享开启互联网上获得链接的人可阅读复制链接。然后feishu2md dl https://domain.feishu.cn/docx/文档token -o ./output等命令打印出Downloaded markdown file to ...打开输出目录你会看到一篇排版完整的.md文件图片已经自动下载到static子目录里链接全部改成了本地相对路径。到这里你已经能跑起来了。接下来可以试试两个进阶玩法让效率再上一个台阶。进阶玩法批量与容器化批量转换文件夹或知识库。这是 feishu2md 最值钱的能力。团队的知识库往往有几十上百篇文档手动转不现实。文件夹模式会递归遍历所有子目录feishu2md dl --batch -o ./docs https://domain.feishu.cn/drive/folder/文件夹token知识库模式则会在本地重建知识库的目录树并且通过并发控制保证速度又不会把 API 打爆feishu2md dl --wiki -o ./wiki_docs https://domain.feishu.cn/wiki/settings/知识库token用 Docker 跑一个 Web 界面。如果你不想碰命令行项目还提供了带网页界面的版本。一条命令即可启动服务docker run -it --rm -p 8080:8080 \ -e FEISHU_APP_ID你的AppID \ -e FEISHU_APP_SECRET你的AppSecret \ wwwsine/feishu2md然后打开浏览器访问http://localhost:8080粘贴文档链接就能下载转换结果适合偶尔用一次、不想配置环境的同事。新手最容易踩的四个坑权限开了还是报错。最常见的原因应用没发布或文档没开启互联网分享。检查文档分享设置里是否选了互联网上获得链接的人可阅读并确认应用已完成发布操作。旧版文档转不了。注意项目只支持新版 docx 文档链接形如/docx/xxx。如果是旧版/docs/xxx链接会直接报不再支持需要先手动把文档另存为新版格式或改用项目保留的 v1 分支。图片下载失败。通常是图片的访问权限或网络问题。临时应急可以在配置文件里把skip_img_download设为true先保住文字内容之后再补图片。链接格式不对。分享链接可能带着多余的查询参数工具的正则只认https://域名/docx/token这种纯净格式多余参数记得去掉。一个真实的迁移案例有个技术团队要把飞书上 200 多篇 API 文档迁到自建的文档系统原来预估要花一周时间手动处理。后来他们写了个小脚本把知识库链接喂给feishu2md dl --wiki只跑了不到半小时所有文档按原目录结构落盘代码块语言高亮、表格、图片一个不少。剩下的时间全花在人工抽查和少量手动微调上。这就是工具的价值把重复劳动压缩到可以忽略不计。项目现状与参与方式feishu2md 目前处于社区维护阶段原作者的团队已不再使用飞书文档项目正在寻找新的维护者。代码结构很清晰URL 解析在utils/url.goAPI 封装在core/client.go最核心的文档解析引擎在core/parser.go命令行入口在cmd/目录Web 版本在web/目录。测试用例放在testdata/里面包含多种文档类型的 JSON 和转换后的 Markdown 对照想读懂转换逻辑可以从这里入手。如果你遇到了 bug可以提交 Issue 描述复现步骤如果你熟悉 Go欢迎直接提交 PR自认为有能力长期维护的甚至可以申请成为主协调员。飞书文档转 Markdown 这件事从半小时的手工活变成一条命令这就是 feishu2md 的全部意义。Clone 一份源码到本地跑起来试试或者直接下载 Release 版本把第一篇飞书文档交给它你会回来感谢自己的。【免费下载链接】feishu2md一键命令下载飞书文档为 Markdown寻找维护者项目地址: https://gitcode.com/gh_mirrors/fe/feishu2md创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考