如何使用6种方法将飞书文档快速单篇/批量导出为Markdown？（2024年10月）

飞书是一款全能的办公软件，今天主要讲的是飞书云文档这一块，需求是将飞书文档导出为markdown格式，但是飞书默认只支持Word和PDF两种格式。

在网上查到 feishu2md 这个工具，但是需要申请 API Token 等步骤，比较繁琐。最后直接选择弃用。

通过尝试，阿斌发现可以通过将飞书的内容复制到为知笔记中实现这一目的，而且操作也非常简单。导出的Markdown 格式 与原来的飞书差别不大，图片也能一起复制进去。下图是操作后的效果：

飞书文档单篇导出markdown

• Chrome插件：Cloud Document Converter（开源地址） 支持下载、复制飞书云文档为 Markdown。

为知笔记导出飞书文档

目前只尝试了文字类和表格类（不支持多维表格）的，都可以

1. 打开飞书文档全选（Ctrl+A），复制

2. 打开为知笔记客户端，新建一个笔记，粘贴即可

3. 右键为知笔记，导出 - 导出为Markdown

   

Typora导出飞书文档

1. 打开飞书文档全选（Ctrl+A），复制

2. 打开 Typora ，新建一个md文件，粘贴即可（有时文档中的图片会无法复制过来，需要自行下载）

   

飞书文档多篇导出Markdown

1. feishu-backup： 用于备份飞书文档，可以将飞书文档转成markdown下载。（飞书文档转成markdown教程地址）

   • 目前只支持doc和docx和文件的下载。其他的表格、多维表格都不支持，请考虑手动导出。云文档下载后将会被转换成markdown，图片将被放在文档同级目录。
2. feishu-pages：导出飞书知识库，并按相同目录结构生成 Static Page Generator 支持 Markdown 文件组织方式，用于发布为静态网站。
3. Feishu-doc-export：一个支持Windows、Mac、Linux系统的飞书文档一键导出服务，仅需一行命令即可将飞书知识库的全部文档同步到本地电脑。支持导出markdown，docx，pdf三种格式。导出速度嘎嘎快，实测700多个文档导出只需25分钟，且程序是后台挂机运行，不影响正常工作。

Feishu-doc-export使用教程

我在 作者写的飞书教程 里踩了几个坑，记录一下，以防大家再踩。

1. 开通权限时，按照作者发的权限搜索开通并发布版本审核（飞书官方文档：管理员审核应用），权限不全会报错。报错如下的，是wiki权限没开通，搜索 wiki 把权限全部开通。

   【ERROR】请求异常！！！
   异常信息： 服务器响应了错误的http状态码：400 Bad Request，
   堆栈信息：    at WebApiClientCore.Implementations.DefaultApiActionInvoker`1.InvokeAsync(HttpClientContext context, Object[] arguments)
     at feishu_doc_export.HttpApi.FeiShuHttpApiCaller.GetWikiSpaces()，
   响应信息：{"code":99991672,"msg":"Access denied. One of the following scopes is required: [wiki:wiki, wiki:wiki:readonly]","error":{"log_id":"20240509113806AAD73AD4BF6CB845AA18","permission_violations":[{"type":"action_scope_required","subject":"wiki:wiki"},{"type":"action_scope_required","subject":"wiki:wiki:readonly"}],"helps":[{"url":"https://open.feishu.cn/app/cli_a22c56e7fcf8d00b/auth?q=wiki:wiki,wiki:wiki:readonly&op_from=openapi","description":"Learn more about scopes and how to add them: [wiki:wiki,wiki:wiki:readonly]"}],"message":"Refer to the documentation to fix the error: https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-fix-the-99991672-error"}}
   （请按任意键退出！）

   • 通过手机号或邮箱获取用户 ID (contact:user.id:readonly)
   • 查看、评论和导出文档 (docs:doc:readonly)
   • 查看新版文档 (docx:document:readonly)
   • 查看、评论和下载云空间中所有文件 (drive:drive:readonly)
   • 查看和下载云空间中的文件 (drive:file:readonly)
   • 查看、评论、编辑和管理多维表格 (bitable:app)
   • 下载云文档中的图片和附件 (docs:document.media:download)
   • 导出云文档 (docs:document:export)
   • 查看、评论、编辑和管理云空间中所有文件 (drive:drive)
   • 查看、评论、编辑和管理电子表格 (sheets:spreadsheet)

   

2. 飞书知识库设置 - 成员设置 - 添加管理员：搜索群组名称

   

3. 全部设置成功后，下载时飞书文档自动转为Markdown格式

   

总结

通过为知笔记将飞书文档导出Markdown的方式基本满足了导出的需求，而且保留了原来的格式，但缺点就是只能导出一篇飞书文档。希望飞书早日支持导出Markdown格式吧。