告别复制粘贴：用 feishu2md 三步搞定飞书文档转 Markdown

告别复制粘贴用 feishu2md 三步搞定飞书文档转 Markdown【免费下载链接】feishu2md一键命令下载飞书文档为 Markdown寻找维护者项目地址: https://gitcode.com/gh_mirrors/fe/feishu2md深夜十一点阿杰盯着屏幕上的飞书文档发愁。这是一份四十多页的技术方案明天要同步到团队 Git 仓库而仓库只认 Markdown。他尝试了导出 Word 再转格式结果表格全乱、图片丢失、代码块缩进成一团手动复制粘贴倒是可行但四十分钟后他还在跟临时图片链接搏斗——那些链接只有 24 小时有效期。你是不是也遇到过类似的场景飞书文档写起来顺手导出却成了老大难。今天要介绍的 feishu2md就是一个用 Go 写成的开源小工具专治飞书文档转 Markdown这件事一条命令搞定不用跟格式较劲。为什么飞书文档导出 Markdown 这么麻烦先说清楚问题根源你才能理解这个工具的价值。飞书官方只支持导出 Word 和 PDF 两种格式。Word 导出后再用转换工具处理会踩三个坑样式错乱飞书用自定义样式而非标准富文本样式转换后列表消失、换行冗余图片失效复制粘贴得到的图片链接是临时的24 小时后全部过期代码块损坏缩进和语言标记经常丢失还得手动修说白了手动方案的本质是用时间换格式文档越长越痛苦。feishu2md 的思路完全不同——它不碰导出功能而是直接通过飞书开放平台的 API 读取文档结构在本地重新渲染成 Markdown相当于绕过了所有中间环节。三步完成飞书文档转 Markdown 配置上手成本比你想象的低整个过程只需要三条命令。第一步创建飞书应用并开通权限去飞书开发者后台创建一个企业自建应用然后开通四类权限查看新版文档docx:document:readonly、下载云文档中的图片和附件docs:document.media:download、查看云空间文件drive:file:readonly、查看知识库wiki:wiki:readonly。最后在凭证与基础信息里抄下 App ID 和 App Secret。第二步写入配置feishu2md config --appId YOUR_APP_ID --appSecret YOUR_APP_SECRET配置会写入系统用户目录下的 feishu2md/config.json运行feishu2md config可以随时查看路径和当前配置。以后再也不用重复输入凭证。第三步转换文档feishu2md dl https://domain.feishu.cn/docx/docxtoken文档链接通过分享 开启链接分享 互联网上获得链接的人可阅读 复制链接获取转换完成的 .md 文件直接落在当前目录。整个流程走下来不到三分钟多数时间花在申请权限上真正的转换是秒级的。一条命令的三种形态单篇、文件夹与知识库feishu2md 的命令行设计得很克制核心就一个dldownload子命令但通过两个开关覆盖了三种使用场景。场景命令适用对象单篇文档feishu2md dl docx链接单篇零散文档批量文件夹feishu2md dl --batch -o docs/ 文件夹链接云空间某个目录整个知识库feishu2md dl --wiki -o wiki_docs/ 知识库链接Wiki 全部页面值得说的是批量模式的细节文件夹会递归遍历子目录并保持目录结构知识库则按节点层级建目录每个文档并发下载最多 10 个并发任务几十篇文档的迁移也是分分钟的事。-o参数指定输出目录图片会默认存到 static/ 子文件夹并自动替换为相对路径引用拿到的 Markdown 是开箱即用的。转换质量如何它能处理哪些元素工具核心是 core/parser.go 里的解析引擎直接把飞书文档的块结构Block映射成 Markdown 语法。实测过 testdata 里的样例文档以下元素都能较好地还原标题层级 H1-H6、粗体、斜体、删除线、行内代码有序列表、无序列表、任务列表表格保持列对齐符合 GFM 语法代码块内置数十种语言映射包括 Go、Python、JavaScript、SQL、YAML 等图片自动下载并重写为本地相对路径引用块、分割线、脚注另外它还内置了 lute 引擎做格式化输出的 Markdown 会自动规范空格与排版不是那种能看但很脏的结果。配置文件里还能调几个开关title_as_filename用文档标题命名文件、use_html_tags保留 HTML 标签、skip_img_download跳过图片下载。不想装命令行Web 版同样能用feishu2md 还附带一个 Docker Web 版本适合不想碰命令行的同事或非技术用户docker run -it --rm -p 8080:8080 \ -e FEISHU_APP_IDyour_id \ -e FEISHU_APP_SECRETyour_secret \ -e GIN_MODErelease \ wwwsine/feishu2md启动后访问 http://localhost:8080粘贴文档链接即可转换浏览器直接下载生成的 .md 文件或包含图片的 zip 包。团队里可以部署一个共享实例人人都能用不用各自申请凭证。三个容易踩的坑与解法坑一提示权限不足。应用开通权限后需要发布生效且文档必须开启互联网上获得链接的人可阅读。文件夹和知识库同理链接要有对应的查看权限。坑二旧版 docs 文档不支持。工具只支持新版 docx 文档遇到旧版会直接报错提示可改用 v1.4.0 归档版本处理存量文档。坑三转换后格式有细微差异。飞书某些复杂排版如嵌套表格、画板无法 100% 还原建议转换后快速扫一遍这类极少数情况手动微调即可不影响整体流程。下一步行动清单如果你正被飞书文档迁移困扰不妨按这份清单走一遍花两分钟在飞书开发者后台创建应用、开通四类权限用feishu2md config写入 App ID 和 App Secret先拿一篇文档试转换检查图片和表格效果确认满意后用--batch或--wiki处理批量内容需要团队协作时部署 Docker Web 版共享入口顺带一提这个项目目前正在寻找社区维护者如果你熟悉 Go 语言、想参与开源核心代码就在 core/ 目录测试样例在 testdata/ 目录从修 issue 开始是个不错的切入点。文档迁移这件事真的不该靠复制粘贴熬到深夜。【免费下载链接】feishu2md一键命令下载飞书文档为 Markdown寻找维护者项目地址: https://gitcode.com/gh_mirrors/fe/feishu2md创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考