语雀导出指南：用 Yuque Exporter 一键把语雀文档转 Markdown

语雀导出指南：用 Yuque Exporter 一键把语雀文档转 Markdown

【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter

想把语雀笔记搬去自建博客或 GitHub Pages？官方批量导出只给私有 lakebook 或 pdf 格式，Markdown 只能一篇篇手点，上百篇文档基本劝退。Yuque Exporter 把这事自动化：一条命令，模拟浏览器把你所有知识库逐篇导出为 Markdown，目录结构原样保留。

语雀文档一键导出步骤

先装 Node.js，并确认机器上有 Chromium 系浏览器（Chrome、Edge、Brave 都行）。工具的核心依赖 Puppeteer 本质上就是驱动这个浏览器替你干活。

然后下载代码并安装依赖：

git clone https://gitcode.com/gh_mirrors/yu/yuque-exporter cd yuque-exporter npm install

第一次运行需要登录：用环境变量指定语雀账号密码，成功后 cookie 会自动存到本地，之后直接运行就能复用登录态。最小命令就是：

USER=xxx PASSWORD=xxx node main.js

文件默认存到当前目录的 output 文件夹，也可以用 EXPORT_PATH 指定位置。导出完成后，再跑一下自带的 Python 脚本，能把文档里的图片全部下载到本地，并把 Markdown 里的图片链接改写成相对路径，保证文档搬家后图片不裂。

格式为什么不丢

模拟真实浏览器登录，不碰 API

工具不依赖任何 token。它打开一个无界面的 Chromium，走和你手动登录一样的流程：切到密码登录、拖动滑块、勾选协议。首次成功后保存 cookie，下次自动用 cookie 登录，也不用重复输入密码。

Markdown 来自语雀官方导出

登录后它先拉取你的知识库列表和目录结构，再逐篇走网页上"导出 Markdown"同一个官方入口下载。所以代码块、标题等格式和你手动点出来的完全一致，区别只是不用你点几百次，而且文件会按知识库原有的层级放进对应文件夹。

失败自动重试，图片也能一起搬

某一篇下载超时或失败时会自动重试最多 3 次；极少数仍然失败的（纯表格、思维导图文档，官方也不支持直接导 Markdown），需要手动补一次。

上面是项目 README 里的导出过程演示动图（旧版本画面）。

适合谁、什么时候用

• 如果你是普通用户或会员，用不上官方批量 Markdown 导出，那么"模拟浏览器逐篇导出"就是最省事的替代，一条命令带走整个知识库。
• 如果你计划把语雀迁移到 GitLab、GitHub Pages 或自建博客，那么导出再配合图片脚本，整库就是一套可直接丢给静态博客的 Markdown。
• 如果你想给重要笔记留一份离线副本，那么定期跑一次，导出的目录就是你的备份。

动手之前

建议先拿最小的一个知识库试跑一次：确认目录结构和代码块格式符合预期，再导出全部仓库。另外工具靠模拟浏览器操作，官方前端改版后可能要手动修一下源码，全量导出前记得先备份已导出的结果。

【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter