飞书文档转 Markdown 完整指南feishu2md 一条命令打通文档工作流【免费下载链接】feishu2md一键命令下载飞书文档为 Markdown寻找维护者项目地址: https://gitcode.com/gh_mirrors/fe/feishu2md「文档在飞书里写好了发布却卡在格式上」——这是研发、产品和运营团队几乎都踩过的坑。飞书文档转 Markdown 的需求无处不在技术方案要提交进 Git 仓库、接口文档要发布到内部知识库、个人笔记要同步到博客。而开源工具feishu2md恰好把这件事压缩成了一条命令feishu2md dl 文档链接几秒输出标准 Markdown标题、列表、表格、代码块、图片全部保留。本文就从零开始带你完整走一遍它的上手与实战流程。快速开始三步跑通第一条转换命令feishu2md 是 Go 编写的单文件命令行工具无需运行时依赖安装方式任选其一# 方式一下载对应平台的 Release 可执行文件放入 PATH 路径 # 方式二拉取源码自行编译 git clone https://gitcode.com/gh_mirrors/fe/feishu2md cd feishu2md go build -o feishu2md .装好后依次执行两条命令就能完成第一次转换# 第 1 步写入飞书开放平台的凭证App ID 与 App Secret feishu2md config --appId YOUR_APP_ID --appSecret YOUR_APP_SECRET # 第 2 步把文档分享链接丢给 dl 命令默认输出到当前目录 feishu2md dl https://your-domain.feishu.cn/docx/docxtoken文档链接从哪里来在飞书文档右上角点击「分享 → 开启链接分享 → 互联网上获得链接的人可阅读 → 复制链接」。整个过程不超过一分钟剩下的交给工具即可。核心能力一览三种模式各显身手feishu2md 不只会转单篇文档它按使用场景拆出了三种模式覆盖面相当完整模式适用场景一句话命令单篇转换转一篇具体文档最常用的日常操作feishu2md dl 文档链接文件夹批量一次性导出云盘中某个文件夹内的全部文档feishu2md dl --batch 文件夹链接知识库 Wiki把整个知识库的文档全部同步下来feishu2md dl --wiki 知识库设置链接批量转换飞书文档时-o参数可以指定输出目录比如feishu2md dl --batch -o docs/ 文件夹链接转换结果会整齐地落在指定文件夹里。知识库模式则适合做整库备份或迁移一条命令带走全部内容。配置指南创建应用、开通权限、写入凭证feishu2md 本身不保存任何账号信息它通过飞书开放平台的 OpenAPI 读取文档内容所以使用前需要完成一次性的「应用创建」配置进入飞书开放平台的开发者后台创建一个「企业自建应用」名称与图标可随意填写在「权限管理」中开通下表所列的只读权限在「凭证与基础信息」页面复制 App ID 和 App Secret回到终端执行feishu2md config --appId ... --appSecret ...写入配置。核心权限清单如下全部为只读级别不涉及任何写操作权限标识用途说明docx:document:readonly查看新版文档读取文档基本信息和全部内容块docs:document.media:download下载云文档中的图片和附件供转换时保存到本地drive:file:readonly查看云空间文件用于枚举文件夹内的文档清单wiki:wiki:readonly查看知识库读取知识空间节点信息配置完成后随时可以用feishu2md config查看配置文件路径与当前状态无需重复配置。更细致的输出选项比如图片目录、是否保留原图链接可在配置文件中手动调整。实战流程从飞书写稿到 Git 入库的一条龙下面用一个连贯的场景把整套工作流串起来假设你是团队里的技术文档负责人需要把一篇飞书上的《服务部署手册》发布到公司 Wiki同时提交一份到 Git 仓库存档。第一步飞书写稿。在飞书里正常排版H1/H2 标题、有序步骤、代码块、一张架构图全部用飞书原生能力完成不需要为「导出」做任何额外准备。第二步一键转换。开启文档的链接分享并复制链接执行feishu2md dl -o deploy/ https://your-domain.feishu.cn/docx/deploy-token几秒后deploy/目录下出现服务部署手册.md图片也一并下载到了本地资源目录Markdown 里引用的是相对路径拷贝整个文件夹即可完整迁移。第三步入库与发布。把转换结果推送到 Git 仓库形成版本管理同时将 Markdown 直接粘贴进支持 Markdown 的 Wiki 系统或交给静态博客框架渲染发布。飞书文档导出 Markdown 教程里的常规痛点——表格错位、代码块丢失、图片外链失效——在这一步基本不会出现因为格式在转换时就已固化好。整个过程从写完文档到内容上线耗时以分钟计且随时可以重复执行文档更新后重跑一次命令即可同步。工作原理与代码结构feishu2md 的转换链路可以概括为「解析链接 → 请求 OpenAPI → 解析内容块 → 输出 Markdown」四步先识别 URL 中的文档类型与 token再调用飞书开放平台接口拉取文档的结构化数据随后把一个个「块」标题、段落、表格、代码、图片翻译成对应的 Markdown 语法最后连同图片素材一起落盘。项目代码按职责划分为三个模块cmd/命令行入口负责config与dl两个子命令的参数解析core/核心逻辑其中 core/parser.go 是内容解析引擎负责把飞书文档结构转换为 Markdownutils/通用工具包括 URL 解析与配置读写等辅助函数。如果你对某个格式细节比如表格如何对齐、代码块语言如何识别感兴趣直接翻 core/parser.go 就能找到对应实现。此外项目还提供了官方文档 docs/official.md涵盖更完整的参数说明与注意事项。常见问题速查问题现象解决办法报错「无法解析链接」确认复制的是分享链接含 docx/folder/wiki 标识而不是浏览器地址栏里的编辑态链接转换结果缺少图片检查是否开通docs:document.media:download权限并确认网络可以访问飞书素材域名文件夹批量转换失败确认链接是drive/folder类型且已公开分享注意 Docker 版本暂不支持--batch模式旧版文档转不出来v2 仅支持新版 docx 文档旧版v1文档请改用 v1_support 分支的归档版本找不到配置文件执行feishu2md config会直接打印配置文件路径与当前配置内容社区与贡献feishu2md 目前是社区维护的开源项目原作者已不再深度使用飞书文档项目正在公开寻找维护者——这反而意味着你有很大的参与空间报告问题使用中遇到 Bug 或兼容性问题在项目里提交 Issue 并附上复现步骤即可提交代码用git clone https://gitcode.com/gh_mirrors/fe/feishu2md拉取源码修好问题后提交 PR补充文档完善 docs/official.md 或补充使用示例文档贡献同样重要分享用例把你用 feishu2md 搭建的工作流写成文章让更多场景被看见。项目自带的testdata/目录包含多种文档类型的转换样例改动解析逻辑后跑一遍测试即可验证效果参与门槛并不高。结语把飞书文档转 Markdown 这件事交给 feishu2md你得到的是⚡一条命令feishu2md dl搞定单篇、文件夹、知识库三种场景格式完整标题层级、列表、表格、代码块、图片全部保留轻量跨平台Go 单文件编译无运行时依赖开源免费代码透明社区维护欢迎任何人加入。如果飞书文档的归档和迁移正在困扰你不妨现在就 clone 一份源码或直接下载发行版用第一条命令开启你的高效文档工作流。【免费下载链接】feishu2md一键命令下载飞书文档为 Markdown寻找维护者项目地址: https://gitcode.com/gh_mirrors/fe/feishu2md创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考