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 个核心命令全部列在下面这张表里你想做的事命令说明转换单个文档feishu2md dl 文档链接最快 60 秒出结果转换整个文件夹feishu2md dl --batch -o docs/ 文件夹链接递归处理子文件夹目录结构原样保留转换整个知识库feishu2md dl --wiki -o wiki/ 知识库设置链接最多 10 个文档并发下载三个进阶玩法定时同步、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图片统一存到哪个目录默认statictitle_as_filename用文档标题命名文件而不是一串看不懂的 tokenskip_img_download设为 true 时只保留原图链接、不下载图片适合场景批量归档时统一图片目录、让文件名可读方便后续入库和检索。三个人的真实变化以前 vs 现在 运维工程师阿凯以前每次发版前要把飞书上的变更记录手动整理成 Markdown 贴进发布文档一次至少 20 分钟现在配好定时任务发布前 3 秒拉最新版本直接提交。产品经理小鹿以前写周报要手动汇总 3 个文档复制表格总错位气得想摔键盘现在一条--batch命令把整个文件夹拉下来表格原样保留拼进周报收工。自由职业者老周以前每做完一个项目飞书笔记里的图要一张张另存再手动贴进博客现在一条命令连文带图打包成 Markdown提交归档干净利落。新手最容易踩的 3 个坑 QApp 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考