飞书文档转Markdown一条命令就够了feishu2md 完整上手指南【免费下载链接】feishu2md一键命令下载飞书文档为 Markdown寻找维护者项目地址: https://gitcode.com/gh_mirrors/fe/feishu2md上周同事老周被一份搬不动的文档困住了老周负责的团队一直用飞书写接口文档。那天版本上线他要把二十多篇文档挪进公司的 Git 仓库做归档结果在飞书里翻了半天导出只有 Word 和 PDF 两种格式Word 转出来的 Markdown 排版全乱图片还变成了一堆失效的临时链接。他只好打开文档一段段复制、一张张截图忙到下班才搬完三分之一。这事听起来很熟悉吧飞书写文档确实舒服但它偏偏不提供导出为 Markdown这个按钮。而 Markdown 恰恰是 Git 仓库、博客平台、内部 Wiki 最通用的文档格式。这两者之间缺的就是一个小工具。feishu2md就是来补这个缺口的它用 Go 语言编写输入一条命令就能把飞书文档完整下载成标准 Markdown 文件图片自动帮你存好、表格和代码块原样保留。整个过程只需要几秒钟。第一次使用两条命令跑通全流程你不需要任何编程基础。feishu2md 的使用流程简单到可以分成两步。第一步去飞书开放平台创建一个企业自建应用拿到 App ID 和 App Secret。然后在应用里开通几个只读权限包括读取文档内容docx:document:readonly、下载图片附件docs:document.media:download、查看云空间文件drive:file:readonly和查看知识库wiki:wiki:readonly。放心全部是只读不会动你的任何文档。第二步把凭证交给工具feishu2md config --appId 你的APP_ID --appSecret 你的APP_SECRET它会自动在系统配置目录下生成config.json以后再也不用重复配置。想看配置是否就绪直接输入feishu2md config即可。然后把飞书文档链接复制过来feishu2md dl https://xxx.feishu.cn/docx/文档token回车等一两秒当前目录下就多了一个排版整洁的.md文件。文档里的图片也被自动下载到一个static文件夹里Markdown 中的引用路径已经替你改好。第一次成功看到转换结果的那一刻你大概会和老周一样感慨就这我折腾一下午的活它两秒干完了。能力全景一台文档翻译机如果给 feishu2md 画个像它就像一台摆在飞书和 Markdown 之间的翻译机。你扔进去一个链接它按四道工序工作先由 utils/url.go 识别链接类型、提取文档 token再由 core/client.go 调用飞书 Open API 拉取文档内容和所有资源接着 core/parser.go 把飞书的结构化数据翻译成 Markdown 语法最后 cmd/download.go 把结果写入文件。整个过程环环相扣不需要你干预任何一步。这台翻译机能处理的语料相当丰富文本样式粗体、斜体、下划线、删除线、高亮原样保留标题层级H1 到 H6 自动对应 Markdown 标题语法列表有序、无序、任务清单都能正确转换表格保持行列结构输出为标准的 Markdown 表格代码块识别几十种编程语言并标注语言类型高亮不丢图片自动下载到本地并改写引用路径这是最省心的部分。换句话说你在飞书里精心排版的文档转换后基本不用返工。谁在用三个对号入座的真实场景场景一技术团队的文档搬家。团队决定把飞书上的架构设计、部署手册、故障排查文档整体迁移到自建 Wiki。如果手动搬几十篇文档要耗掉好几个人天用 feishu2md 批量转换一天内就能全部落地。场景二个人博主的工作流。很多写作者习惯在飞书里写稿但发布平台只认 Markdown。过去要复制全文、手动处理临时图片链接飞书图片链接只有 24 小时有效期稍不注意就失效现在一篇稿子转换完直接扔进博客流程图片问题一次解决。场景三跨团队的文档协作。市场团队用飞书写产品白皮书技术团队想在上面补充细节。把文档转成 Markdown 放进 Git 仓库后两个团队就能用代码评审的方式协作改文档版本历史清清楚楚。进阶玩法把转换变成自动化流水线feishu2md 不只能转单篇文档。它支持的批量模式才是真正省时间的重头戏。批量转换整个文件夹。文件夹支持嵌套子文件夹会被递归扫描转换结果按原结构存放且文档并发下载、速度很快feishu2md dl --batch -o docs/ https://xxx.feishu.cn/drive/folder/文件夹token一键搬空整个知识库。如果文档都挂在飞书知识库Wiki里可以用--wiki参数连树形结构一起搬下来feishu2md dl --wiki -o wiki_docs/ https://xxx.feishu.cn/wiki/settings/知识库token不想装命令行项目提供了 Docker 镜像跑起来就是一个网页版转换器浏览器里粘贴链接即可下载适合偶尔用一两次的场景docker run -it --rm -p 8080:8080 \ -e FEISHU_APP_ID你的ID \ -e FEISHU_APP_SECRET你的Secret \ -e GIN_MODErelease \ wwwsine/feishu2md然后访问http://localhost:8080就能使用。自定义输出行为。打开生成的配置文件有几个实用开关image_dir设置图片存放目录title_as_filename让输出文件用文档标题命名而不是 tokenskip_img_download跳过图片下载、保留原始链接use_html_tags控制部分复杂格式用 HTML 标签输出。比如你只想快速抓取文字、不在乎图片把skip_img_download设为true就行。避坑手册过来人的几句叮嘱旧版文档docs 类型已不再支持。工具目前只支持新版文档docx。如果你还在用旧版需要到项目的 v1_support 分支或 v1.4.0 归档版本去用README 里写得很清楚。权限不足是最高频的问题。转换报错时八成是应用权限没开全或者文档没有开启互联网上获得链接的人可阅读。记得检查这两处而不是怀疑工具坏了。文件夹批量模式暂时不支持 Docker 版。需要用批量功能的话请使用命令行版本。复杂排版可能有细微差异。Markdown 本身标准众多遇到特别复杂的布局比如合并单元格、特殊嵌套转换结果可能需要手动微调几处。建议转换后快速扫一遍。排错思路先单篇后批量。批量转换出问题时先拿单篇文档试确认链接和权限都没问题再排查批量参数。社区与贡献这个项目正在寻找维护者feishu2md 是一个开源项目由 Go 语言实现代码结构清晰测试用例也很完整。目前项目处于社区维护阶段原作者已不再使用飞书文档所以特别欢迎社区接手——如果你有意愿可以成为主协调员。参与方式很灵活使用中遇到 bug提交 Issue 描述复现步骤想贡献代码克隆仓库https://gitcode.com/gh_mirrors/fe/feishu2md后在core/和cmd/目录里动手不懂代码也没关系帮忙完善文档、分享使用案例同样是贡献。转换效果的参考样例就在testdata/目录里对比着看能快速理解工具的能力边界。写在最后老周后来把工具推荐给了整个部门。现在他归档文档的流程是复制链接、粘贴、回车然后去泡杯咖啡。飞书负责写得好Git 仓库负责存得住feishu2md 就是中间那条最短的传送带。如果你也在为飞书文档的格式转换发愁不妨现在就装一个试试。下载对应平台的可执行文件跑通config和dl两条命令然后把你手头最头疼的那篇文档交给它——大概率会有惊喜。【免费下载链接】feishu2md一键命令下载飞书文档为 Markdown寻找维护者项目地址: https://gitcode.com/gh_mirrors/fe/feishu2md创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 飞书文档转Markdown，一条命令就够了：feishu2md 完整上手指南
飞书文档转Markdown一条命令就够了feishu2md 完整上手指南【免费下载链接】feishu2md一键命令下载飞书文档为 Markdown寻找维护者项目地址: https://gitcode.com/gh_mirrors/fe/feishu2md上周同事老周被一份搬不动的文档困住了老周负责的团队一直用飞书写接口文档。那天版本上线他要把二十多篇文档挪进公司的 Git 仓库做归档结果在飞书里翻了半天导出只有 Word 和 PDF 两种格式Word 转出来的 Markdown 排版全乱图片还变成了一堆失效的临时链接。他只好打开文档一段段复制、一张张截图忙到下班才搬完三分之一。这事听起来很熟悉吧飞书写文档确实舒服但它偏偏不提供导出为 Markdown这个按钮。而 Markdown 恰恰是 Git 仓库、博客平台、内部 Wiki 最通用的文档格式。这两者之间缺的就是一个小工具。feishu2md就是来补这个缺口的它用 Go 语言编写输入一条命令就能把飞书文档完整下载成标准 Markdown 文件图片自动帮你存好、表格和代码块原样保留。整个过程只需要几秒钟。第一次使用两条命令跑通全流程你不需要任何编程基础。feishu2md 的使用流程简单到可以分成两步。第一步去飞书开放平台创建一个企业自建应用拿到 App ID 和 App Secret。然后在应用里开通几个只读权限包括读取文档内容docx:document:readonly、下载图片附件docs:document.media:download、查看云空间文件drive:file:readonly和查看知识库wiki:wiki:readonly。放心全部是只读不会动你的任何文档。第二步把凭证交给工具feishu2md config --appId 你的APP_ID --appSecret 你的APP_SECRET它会自动在系统配置目录下生成config.json以后再也不用重复配置。想看配置是否就绪直接输入feishu2md config即可。然后把飞书文档链接复制过来feishu2md dl https://xxx.feishu.cn/docx/文档token回车等一两秒当前目录下就多了一个排版整洁的.md文件。文档里的图片也被自动下载到一个static文件夹里Markdown 中的引用路径已经替你改好。第一次成功看到转换结果的那一刻你大概会和老周一样感慨就这我折腾一下午的活它两秒干完了。能力全景一台文档翻译机如果给 feishu2md 画个像它就像一台摆在飞书和 Markdown 之间的翻译机。你扔进去一个链接它按四道工序工作先由 utils/url.go 识别链接类型、提取文档 token再由 core/client.go 调用飞书 Open API 拉取文档内容和所有资源接着 core/parser.go 把飞书的结构化数据翻译成 Markdown 语法最后 cmd/download.go 把结果写入文件。整个过程环环相扣不需要你干预任何一步。这台翻译机能处理的语料相当丰富文本样式粗体、斜体、下划线、删除线、高亮原样保留标题层级H1 到 H6 自动对应 Markdown 标题语法列表有序、无序、任务清单都能正确转换表格保持行列结构输出为标准的 Markdown 表格代码块识别几十种编程语言并标注语言类型高亮不丢图片自动下载到本地并改写引用路径这是最省心的部分。换句话说你在飞书里精心排版的文档转换后基本不用返工。谁在用三个对号入座的真实场景场景一技术团队的文档搬家。团队决定把飞书上的架构设计、部署手册、故障排查文档整体迁移到自建 Wiki。如果手动搬几十篇文档要耗掉好几个人天用 feishu2md 批量转换一天内就能全部落地。场景二个人博主的工作流。很多写作者习惯在飞书里写稿但发布平台只认 Markdown。过去要复制全文、手动处理临时图片链接飞书图片链接只有 24 小时有效期稍不注意就失效现在一篇稿子转换完直接扔进博客流程图片问题一次解决。场景三跨团队的文档协作。市场团队用飞书写产品白皮书技术团队想在上面补充细节。把文档转成 Markdown 放进 Git 仓库后两个团队就能用代码评审的方式协作改文档版本历史清清楚楚。进阶玩法把转换变成自动化流水线feishu2md 不只能转单篇文档。它支持的批量模式才是真正省时间的重头戏。批量转换整个文件夹。文件夹支持嵌套子文件夹会被递归扫描转换结果按原结构存放且文档并发下载、速度很快feishu2md dl --batch -o docs/ https://xxx.feishu.cn/drive/folder/文件夹token一键搬空整个知识库。如果文档都挂在飞书知识库Wiki里可以用--wiki参数连树形结构一起搬下来feishu2md dl --wiki -o wiki_docs/ https://xxx.feishu.cn/wiki/settings/知识库token不想装命令行项目提供了 Docker 镜像跑起来就是一个网页版转换器浏览器里粘贴链接即可下载适合偶尔用一两次的场景docker run -it --rm -p 8080:8080 \ -e FEISHU_APP_ID你的ID \ -e FEISHU_APP_SECRET你的Secret \ -e GIN_MODErelease \ wwwsine/feishu2md然后访问http://localhost:8080就能使用。自定义输出行为。打开生成的配置文件有几个实用开关image_dir设置图片存放目录title_as_filename让输出文件用文档标题命名而不是 tokenskip_img_download跳过图片下载、保留原始链接use_html_tags控制部分复杂格式用 HTML 标签输出。比如你只想快速抓取文字、不在乎图片把skip_img_download设为true就行。避坑手册过来人的几句叮嘱旧版文档docs 类型已不再支持。工具目前只支持新版文档docx。如果你还在用旧版需要到项目的 v1_support 分支或 v1.4.0 归档版本去用README 里写得很清楚。权限不足是最高频的问题。转换报错时八成是应用权限没开全或者文档没有开启互联网上获得链接的人可阅读。记得检查这两处而不是怀疑工具坏了。文件夹批量模式暂时不支持 Docker 版。需要用批量功能的话请使用命令行版本。复杂排版可能有细微差异。Markdown 本身标准众多遇到特别复杂的布局比如合并单元格、特殊嵌套转换结果可能需要手动微调几处。建议转换后快速扫一遍。排错思路先单篇后批量。批量转换出问题时先拿单篇文档试确认链接和权限都没问题再排查批量参数。社区与贡献这个项目正在寻找维护者feishu2md 是一个开源项目由 Go 语言实现代码结构清晰测试用例也很完整。目前项目处于社区维护阶段原作者已不再使用飞书文档所以特别欢迎社区接手——如果你有意愿可以成为主协调员。参与方式很灵活使用中遇到 bug提交 Issue 描述复现步骤想贡献代码克隆仓库https://gitcode.com/gh_mirrors/fe/feishu2md后在core/和cmd/目录里动手不懂代码也没关系帮忙完善文档、分享使用案例同样是贡献。转换效果的参考样例就在testdata/目录里对比着看能快速理解工具的能力边界。写在最后老周后来把工具推荐给了整个部门。现在他归档文档的流程是复制链接、粘贴、回车然后去泡杯咖啡。飞书负责写得好Git 仓库负责存得住feishu2md 就是中间那条最短的传送带。如果你也在为飞书文档的格式转换发愁不妨现在就装一个试试。下载对应平台的可执行文件跑通config和dl两条命令然后把你手头最头疼的那篇文档交给它——大概率会有惊喜。【免费下载链接】feishu2md一键命令下载飞书文档为 Markdown寻找维护者项目地址: https://gitcode.com/gh_mirrors/fe/feishu2md创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考