想把语雀知识库里的所有文档备份到本地,但不知道怎么批量操作?如果你还不确定为什么需要备份,可以先了解定期备份语雀知识库的重要性。本教程用 3 个简单步骤,手把手教你完成语雀知识库的批量导出。全程不需要任何技术知识,不需要命令行,不需要 API Token。
- 使用 YuqueOut 批量导出仅需3步:安装扩展、选择知识库、点击导出
- 支持 Markdown/PDF/Word/JPG 四种格式,文件按原始目录结构存放
- 无需 API Token 或管理员权限,安装即用零配置
你需要一台安装了 Chrome 或 Edge 浏览器的电脑,并且有一个语雀账号。就这些。
如何安装 YuqueOut 扩展?
只需在 Chrome 网上应用店搜索「YuqueOut」并点击安装,30 秒即可完成,无需任何额外配置。
-
打开 Chrome 应用商店,搜索「YuqueOut 语雀导出助手」,或者直接点击安装链接。
-
点击「添加到 Chrome」按钮,在弹出的权限确认中点击「添加扩展程序」。
-
安装完成后,你会在浏览器右上角的工具栏中看到 YuqueOut 的图标。如果看不到,点击工具栏的「拼图」图标,将 YuqueOut 固定到工具栏。
第二步:选择要导出的知识库
-
打开语雀网站(yuque.com)并确保已登录你的账号。
-
点击浏览器工具栏中的 YuqueOut 图标,扩展弹窗会自动获取你的知识库列表。
-
在知识库列表中,勾选你想导出的知识库。你可以:
- 逐个勾选特定知识库
- 使用「全选」功能选择所有知识库
- 在「个人知识库」和「协作知识库」之间切换
怎么批量导出语雀知识库?
选好知识库后,选择导出格式并点击「开始导出」按钮,YuqueOut 会自动遍历所有文档并按目录结构保存到本地。
-
选择导出格式。YuqueOut 支持以下格式:
- Markdown:最通用的格式,可被各种编辑器和平台识别(迁移到其他平台请参考语雀转Markdown完整指南)
- PDF:适合归档和分享,格式固定不变
- Word (Docx):适合需要二次编辑的场景
- JPG 图片:适合长图分享或截图存档
-
根据需要开启图片本地化选项(建议开启,确保图片在离线环境下可用)。
-
点击「开始导出」按钮。YuqueOut 会:
- 自动遍历知识库中的所有文档
- 按原始目录结构创建文件夹
- 逐篇下载文档并保存
- 实时显示导出进度
-
导出完成后,文件会自动保存到浏览器的下载文件夹中。
就是这么简单。三步完成,你的所有语雀文档就安全地备份到了本地。想了解更多工具方案的对比,可以查看语雀导出工具全面对比评测。
导出时有哪些注意事项?
掌握以下进阶技巧可以让导出过程更高效:善用增量导出节省时间、设置定时备份实现自动化、利用一键重试处理失败文档。
技巧一:使用增量导出
如果你之前已经导出过,下次只想导出新增和变更的文档,可以开启「增量导出」选项。YuqueOut 会自动对比,只处理有变化的文档,大幅节省时间。
技巧二:设置定时自动备份
在 YuqueOut 的设置中,你可以配置定时备份。设置好备份周期(比如每周一次),YuqueOut 会在后台自动执行备份,你完全不需要手动操作。
技巧三:导出协作知识库和团队空间
在知识库列表中切换到「协作知识库」或「团队空间」标签,即可看到你有权限访问的所有共享知识库。选中后按同样的方式导出即可。
技巧四:处理导出失败的文档
网络波动可能导致个别文档导出失败。YuqueOut 会在导出结束后列出失败的文档,你可以一键重试这些文档,无需重新导出整个知识库。
语雀导出支持哪些格式?
YuqueOut 支持 Markdown、PDF、Word (Docx) 和 JPG 四种导出格式,覆盖从平台迁移到归档分享的全部场景。
| 格式 | 适用场景 | 优势 | 注意事项 |
|---|---|---|---|
| Markdown | 博客迁移、知识管理、版本控制 | 通用性最强,可被各种工具识别 | 建议同时开启图片本地化 |
| 文档归档、打印、正式分享 | 格式固定,排版一致 | 文件体积较大 | |
| Word | 二次编辑、团队协作 | 可直接在 Office 中编辑 | 复杂排版可能有差异 |
| JPG | 社交分享、长图存档 | 所见即所得 | 不可编辑,不可搜索文本 |
常见问题
YuqueOut 为了避免触发语雀的请求频率限制,会控制导出速度。文档量大时(500+ 篇),导出可能需要几分钟到十几分钟。这是正常的,导出过程中可以正常使用浏览器做其他事情。
文件保存在浏览器的默认下载目录中。你可以在 Chrome 设置 > 下载内容中查看或修改下载路径。
不需要。YuqueOut 不依赖语雀的任何付费功能,只要你能在浏览器中正常访问和阅读文档,就可以导出。
不建议在导出过程中关闭浏览器或关闭语雀页面。YuqueOut 需要在浏览器中运行来处理导出。但你可以正常切换到其他标签页或使用其他程序。