如何把语雀文档批量导出为Markdownyuque-exporter 完整教程【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter想把语雀上的几百篇文档备份到本地或者迁到别的笔记软件却发现官方只允许单篇导出 Markdown批量导出又只有私有格式可选一篇篇手动点显然不现实。yuque-exporter 就是一个免费的语雀批量导出工具用 Puppeteer 驱动无头浏览器模拟真实登录和下载一条命令就能按知识库目录结构把文档完整导出为 Markdown。除了导出本身它还带失败自动重试并附了一个 Python 脚本可以顺带把文档里的图片下载到本地、替换成可长期访问的链接。三步完成语雀文档导出前提是装好 Node.js以及一个 Chromium 内核的浏览器Chrome、Edge 等都行。第 1 步拉代码、装依赖git clone https://gitcode.com/gh_mirrors/yu/yuque-exporter.git cd yuque-exporter npm install如果 npm 下载慢可以先执行npm config set registry https://registry.npm.taobao.org换国内镜像再装。第 2 步配置登录信息macOS / Linux 用 exportWindows 用 PowerShell 的$env:写法两种方式只差语法# macOS / Linux export USER你的账号 export PASSWORD你的密码# Windows PowerShell $env:USER你的账号; $env:PASSWORD你的密码密码里有特殊字符的话记得用单引号包住避免被 shell 转义。第 3 步运行导出node main.js首次运行会自动完成账号密码登录包括滑块验证并把登录态写进 cookies.json之后再跑就不需要任何密码直接node main.js即可。导出结果默认落在./output目录和知识库目录树保持一致想用别的位置就设EXPORT_PATH。环境变量配置对照表变量是否必填作用默认值USER首次必填登录账号—PASSWORD首次必填登录密码有 cookies.json 时可不填—EXPORT_PATH可选文档导出目录不存在会自动创建./outputMARKDOWN_DIR可选图片脚本处理的 Markdown 所在目录./outputDOWNLOAD_IMAGE可选是否把文档中的远程图片下载到 images 子目录trueUPDATE_MDIMG_URL可选是否改写 Markdown 里的图片链接falseREPLACE_IMAGE_HOST可选自定义图片域名格式{host}/{年份}/{文件名}空后三个只在跑图片脚本时生效用不到可以先不管。进阶图片下载与 Markdown 链接替换语雀文档里的图片大多是远程链接备份久了有失效风险。项目自带的 export-image.py 就是解决这个问题的不跑主程序也能单独用python export-image.py默认行为是把所有远程图片下载到output/images/{年份}/下。常用组合不下载图片、只把链接改成本地相对路径DOWNLOAD_IMAGEfalse UPDATE_MDIMG_URLtrue python export-image.py链接指向自建对象存储在上面基础上再加REPLACE_IMAGE_HOSThttps://你的图床域名/上传时按{年份}/{文件名}规则放文件即可。注意 Python 侧依赖如 requests需要自己pip install。避坑指南常见问题 QAQ报 Could not find ChromiumPuppeteer 默认在系统固定路径找浏览器装了 Chrome/Edge 一般没问题路径非默认的话在 main.js 里用executablePath指定浏览器可执行文件。把headless临时改成 false 还能打开真实浏览器观察脚本在干什么调试很好用。Q提示要求填 USER/PASSWORD说明本地没有有效的 cookies.json重新配置这两个变量登录一次即可登录态过期时删掉 cookies.json 重登也一样。Q某篇文档反复 timeout纯表格或思维导图类文档官方本身不支持导出 Markdown重试没意义手动处理即可。普通失败会自动重试 3 次中途看到 retry 提示不用慌。Q还能用多久脚本依赖语雀内部接口官方前端大改时可能罢工好在代码完全开源届时可以自己对照接口修补团队知识库的导出未经测试谨慎尝试。一句话总结装好依赖、喂给账号整套知识库就变成结构完整的 Markdown 备份再也不用一篇篇手动点导出。项目仓库地址见上文的 clone 链接更多已知限制和细节可以直接看仓库根目录的 README.md遇到 bug 也欢迎回仓库反馈。【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何把语雀文档批量导出为Markdown？yuque-exporter 完整教程
如何把语雀文档批量导出为Markdownyuque-exporter 完整教程【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter想把语雀上的几百篇文档备份到本地或者迁到别的笔记软件却发现官方只允许单篇导出 Markdown批量导出又只有私有格式可选一篇篇手动点显然不现实。yuque-exporter 就是一个免费的语雀批量导出工具用 Puppeteer 驱动无头浏览器模拟真实登录和下载一条命令就能按知识库目录结构把文档完整导出为 Markdown。除了导出本身它还带失败自动重试并附了一个 Python 脚本可以顺带把文档里的图片下载到本地、替换成可长期访问的链接。三步完成语雀文档导出前提是装好 Node.js以及一个 Chromium 内核的浏览器Chrome、Edge 等都行。第 1 步拉代码、装依赖git clone https://gitcode.com/gh_mirrors/yu/yuque-exporter.git cd yuque-exporter npm install如果 npm 下载慢可以先执行npm config set registry https://registry.npm.taobao.org换国内镜像再装。第 2 步配置登录信息macOS / Linux 用 exportWindows 用 PowerShell 的$env:写法两种方式只差语法# macOS / Linux export USER你的账号 export PASSWORD你的密码# Windows PowerShell $env:USER你的账号; $env:PASSWORD你的密码密码里有特殊字符的话记得用单引号包住避免被 shell 转义。第 3 步运行导出node main.js首次运行会自动完成账号密码登录包括滑块验证并把登录态写进 cookies.json之后再跑就不需要任何密码直接node main.js即可。导出结果默认落在./output目录和知识库目录树保持一致想用别的位置就设EXPORT_PATH。环境变量配置对照表变量是否必填作用默认值USER首次必填登录账号—PASSWORD首次必填登录密码有 cookies.json 时可不填—EXPORT_PATH可选文档导出目录不存在会自动创建./outputMARKDOWN_DIR可选图片脚本处理的 Markdown 所在目录./outputDOWNLOAD_IMAGE可选是否把文档中的远程图片下载到 images 子目录trueUPDATE_MDIMG_URL可选是否改写 Markdown 里的图片链接falseREPLACE_IMAGE_HOST可选自定义图片域名格式{host}/{年份}/{文件名}空后三个只在跑图片脚本时生效用不到可以先不管。进阶图片下载与 Markdown 链接替换语雀文档里的图片大多是远程链接备份久了有失效风险。项目自带的 export-image.py 就是解决这个问题的不跑主程序也能单独用python export-image.py默认行为是把所有远程图片下载到output/images/{年份}/下。常用组合不下载图片、只把链接改成本地相对路径DOWNLOAD_IMAGEfalse UPDATE_MDIMG_URLtrue python export-image.py链接指向自建对象存储在上面基础上再加REPLACE_IMAGE_HOSThttps://你的图床域名/上传时按{年份}/{文件名}规则放文件即可。注意 Python 侧依赖如 requests需要自己pip install。避坑指南常见问题 QAQ报 Could not find ChromiumPuppeteer 默认在系统固定路径找浏览器装了 Chrome/Edge 一般没问题路径非默认的话在 main.js 里用executablePath指定浏览器可执行文件。把headless临时改成 false 还能打开真实浏览器观察脚本在干什么调试很好用。Q提示要求填 USER/PASSWORD说明本地没有有效的 cookies.json重新配置这两个变量登录一次即可登录态过期时删掉 cookies.json 重登也一样。Q某篇文档反复 timeout纯表格或思维导图类文档官方本身不支持导出 Markdown重试没意义手动处理即可。普通失败会自动重试 3 次中途看到 retry 提示不用慌。Q还能用多久脚本依赖语雀内部接口官方前端大改时可能罢工好在代码完全开源届时可以自己对照接口修补团队知识库的导出未经测试谨慎尝试。一句话总结装好依赖、喂给账号整套知识库就变成结构完整的 Markdown 备份再也不用一篇篇手动点导出。项目仓库地址见上文的 clone 链接更多已知限制和细节可以直接看仓库根目录的 README.md遇到 bug 也欢迎回仓库反馈。【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 RELATED READING
延伸阅读
更多一线实战笔记与深度复盘，助您持续精进
