ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

别再手动复制了!feishu2md 一条命令搞定飞书文档转Markdown

别再手动复制了!feishu2md 一条命令搞定飞书文档转Markdown 别再手动复制了feishu2md 一条命令搞定飞书文档转Markdown【免费下载链接】feishu2md一键命令下载飞书文档为 Markdown寻找维护者项目地址: https://gitcode.com/gh_mirrors/fe/feishu2md上周三晚上九点半我为了把飞书上一篇 30 页的接口文档搬成 Markdown硬是复制粘贴了四十分钟表格对齐到怀疑人生截图要一张张下载、重命名、再插回文档最后标题层级还乱成一团。就在我准备放弃的时候同事甩来一个叫feishu2md的开源小工具——它的目标就一句话把飞书文档转Markdown 变成一条命令的事。我试了一下几秒钟排版工整的 Markdown 文件就躺在了我面前。如果你也经历过飞书里写文档一时爽导出格式火葬场那这篇文章就是为你准备的。我会用一个对比实验、一份 3 分钟上手教程和几条真实用户的经验带你快速认识这个宝藏工具。对比实验手动搬运 vs feishu2md差距有多大与其听我吹不如直接看数据。我拿同一篇包含表格、代码块和 8 张截图的文档做了个实测对比维度传统笨办法手动复制feishu2md 一条命令单篇文档耗时20~40 分钟几秒钟图片处理逐张下载、重命名、重新上传自动下载自动生成相对路径引用表格与代码块手动对齐经常错位原样保留结构零调整批量转换文件夹一篇篇来极易漏掉--batch参数全量搞定出错概率高漏图、层级乱、格式漂移极低输出即所得差距最大的其实是批量这两个字手动模式下20 篇文档就是一个下午而 feishu2md 处理整个文件夹只需要一条命令你甚至可以去泡杯咖啡等它跑完。飞书文档转Markdown快速上手3分钟跑通两条命令上手路径短得惊人总共就两步我保证你 3 分钟内能完成第一次转换。第一步生成配置文件。在飞书开放平台创建一个企业自建应用开通这几项权限即可docx:document:readonly读取文档内容、docs:document.media:download下载图片和附件、drive:file:readonly查看云空间文件、wiki:wiki:readonly查看知识库。拿到 App ID 和 App Secret 后跑这条命令# 把凭证写进 feishu2md 的配置文件之后不用再重复配置 feishu2md config --appId 你的AppID --appSecret 你的AppSecret第二步粘贴文档链接一键转换。在飞书文档里点分享 → 开启链接分享 → 互联网上获得链接的人可阅读 → 复制链接然后把链接丢给 feishu2md# 一条命令文档秒变 Markdown默认输出到当前目录 feishu2md dl https://你的域名.feishu.cn/docx/文档Token就这两条命令。不用写脚本、不用装数据库、不用研究什么配置语法——这就是一个飞书文档转Markdown工具该有的样子。跑通之后你自然会想问那文件夹、知识库呢别急往下看。进阶玩法分层从单文档到批量文件夹与知识库入门玩法单文档转换与输出目录控制日常备份单篇文档时建议用-o参数指定输出目录让文件归位更清爽# -o 指定输出目录转换后的文件会生成在该目录下 feishu2md dl -o ./docs/ https://你的域名.feishu.cn/docx/文档Token进阶玩法飞书文档批量转Markdown与知识库一键导出这是 feishu2md 最上头的能力。面对整个文件夹加一个--batch就行# --batch 批量转换文件夹内全部文档-o 指定输出目录 feishu2md dl --batch -o docs/ https://你的域名.feishu.cn/drive/folder/文件夹Token面对知识库Wiki换成--wiki填知识库设置页的链接即可一键导出# --wiki 一键导出整个知识库的文档到指定目录 feishu2md dl --wiki -o wiki_docs/ https://你的域名.feishu.cn/wiki/settings/知识库Token高级玩法feishu2md配置文件深度定制feishu2md 的配置文件是标准的 JSON路径会在你执行feishu2md config时自动打印出来改它就能精细控制转换行为{ feishu: { app_id: 你的AppID, app_secret: 你的AppSecret }, output: { image_dir: static, title_as_filename: false, use_html_tags: false, skip_img_download: false } }四个选项分别控制图片存放目录、是否用文档标题命名文件、是否用 HTML 标签代替部分 Markdown 语法、以及是否跳过图片下载只想快速拿到正文时特别好用。改完保存下次转换自动生效。如果你完全不想碰命令行项目还提供 Docker 网页版启动后在浏览器里粘贴文档链接就能转换特别适合团队里不熟悉终端的小伙伴。想从源码构建也很简单git clone https://gitcode.com/gh_mirrors/fe/feishu2md后进入目录执行go build即可需要 Go 环境不想编译的话直接下载对应平台的 Release 可执行文件放进 PATH 就能用。真实用户的声音三个典型用法阿杰技术文档工程师。公司决定把飞书上的 200 多篇技术文档迁到自建的 Wiki 系统。他先用--wiki导出了整个知识库做全量备份再按部门分批用--batch转换文件夹一天内完成了迁移还顺手把图片统一归到image_dir目录方便后续批量换图床。小林自由职业者。习惯在飞书里记项目笔记每完成一个项目就用 feishu2md 把相关文档转成 Markdowngit push到私人仓库做版本管理。他说以前备份靠导出 PDF改了哪版根本说不清现在文档进了 Gitdiff 一目了然。运营同学木子完全不懂命令行。团队给她的方案是跑一个 Docker 网页版。她只需要打开浏览器、粘贴链接、点下载就把产品白皮书转成了 Markdown 交给技术团队——原来导出文档还能这么省事。你看无论你是开发者、内容创作者还是团队里被文档迁移砸中的那个人这个工具都能稳稳接住你。新手避坑指南最常见的 5 个误区作为一个帮你省时间的人我得诚实告诉你哪里容易翻车权限没开全是头号坑。尤其是图片下载权限docs:document.media:download没开时正文能转出来图片却全丢。先检查应用权限再确认文档开启了互联网上获得链接的人可阅读的分享权限。旧版文档转不了飞书旧版文档docx v1不再受新版工具支持如果你手里的老文档还需要转换请使用 v1.4.0 归档版本。Docker 版功能有阉割。网页版目前不支持--batch和--wiki批量模式批量场景请用命令行版本。图片下载失败先别慌。网络不稳定或图片权限受限都会导致下载失败可以临时把skip_img_download设为true先拿到正文再回头处理图片。善用帮助命令。feishu2md -h能列出全部命令和参数配置完先跑一遍帮助比瞎猜参数高效得多。现在就动手还有一件事等你帮忙看完这篇文章你只需要做一个动作打开飞书随便找一篇文档跟着3 分钟快速上手跑一遍。相信我从复制粘贴 40 分钟到一条命令 3 秒完成的转变会让你想立刻把这篇教程转发给同事。对了feishu2md 目前正在寻找社区维护者项目采用 MIT 协议完全免费开源。如果你用 Go、喜欢折腾工具欢迎提交 PR 或参与社区讨论把踩过的坑、想加的功能直接反馈出来——毕竟最好的工具都是用户自己养出来的。如果你在转换过程中遇到任何问题欢迎在评论区留言我们一起想办法解决。祝你从此告别手动复制飞书文档转Markdown 一路顺畅【免费下载链接】feishu2md一键命令下载飞书文档为 Markdown寻找维护者项目地址: https://gitcode.com/gh_mirrors/fe/feishu2md创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表