如何快速把语雀文档批量导出为 Markdownyuque-exporter 保姆级指南【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter如果你也是语雀普通用户想把账号里的文档迁移到本地或其他笔记工具多半撞过这堵墙语雀的批量导出只支持 lakebook语雀私有格式和 PDFMarkdown 格式只能一篇一篇手动导上百篇文档足以劝退。yuque-exporter就是为这个痛点而生的语雀文档导出工具——它模拟真实浏览器操作把你的语雀知识库批量转成 Markdown保留目录结构还能把文档里的图片资源下载到本地。适合想一次性搬走文档的普通用户和会员用户哪怕你没写过一行 JavaScript。yuque-exporter 语雀导出工具能帮你做什么模拟真实用户浏览器行为逐篇导出无需 token普通账号就能跑按知识库目录结构生成 Markdown 文件导完不用手动整理层级单篇导出失败支持重试不会因为一篇卡住整个任务把文档里的图片下载到本地并可选择把 Markdown 里的图片链接替换为本地相对路径下图是完整的导出运行过程演示旧版录屏工具主体是一个 Node.js 脚本入口 main.js通过 Puppeteer——一个能用代码控制无头浏览器的库——自动完成登录和导出图片下载部分则由一个 Python 小脚本负责所以环境里需要同时有 Node.js 和 Python。开始安装前三个前置条件一次说清Chromium 内核浏览器Chrome、Edge、Opera、Brave 均可。工具靠它模拟真实用户行为没有它第一步就会失败。Node.js运行 JavaScript 脚本的环境用官方安装包或 nvm 装到 14 即可。Python 3图片下载步骤用到缺requests库时执行pip install requests补上。下载代码并安装依赖一条命令拿到导出工具在终端执行下面三条命令克隆项目并装好依赖git clone https://gitcode.com/gh_mirrors/yu/yuque-exporter cd yuque-exporter npm installnpm install 阶段 Puppeteer 会顺带下载一个 Chromium 内核版本国内网络可能耗时几分钟如果卡在下载上可以先执行npm config set registry https://registry.npmmirror.com换源再装。看到added xxx packages提示依赖就装好了。语雀文档批量导出配置3 个环境变量 1 条命令运行导出前通过环境变量告诉工具你是谁、导到哪里变量名作用是否必填示例值USER语雀登录用户名手机号或邮箱必填保存 cookie 后不再需要13800000000PASSWORD语雀登录密码必填保存 cookie 后不再需要你的密码EXPORT_PATH导出目录非必填默认./output自动创建D:\notes\yuqueWindows 和 macOS/Linux 的环境变量写法不同对照设置即可# Windows PowerShell设置变量后启动导出 $env:USER13800000000;$env:PASSWORD你的密码;$env:EXPORT_PATHD:\notes\yuque node .\main.js# macOS / Linux密码含特殊字符建议用单引号 export USER13800000000 export PASSWORD你的密码 export EXPORT_PATH/path/to/export node main.js首次运行会自动填账号密码登录包含滑动验证成功后把登录态保存为项目下的cookies.json之后再运行直接复用无需重复输密码 ✅。看到Login successfully!和Start export all books ...两条日志说明批量导出已开跑Markdown 会按知识库和章节整理到 EXPORT_PATH 目录下。语雀图片资源下载一条命令把图片链接换成本地路径导出的 Markdown 里图片默认还指向语雀服务器。想连图片一起带走运行 Python 脚本export-image.py相关变量变量名作用是否必填示例值MARKDOWN_DIRMarkdown 所在目录非必填默认./outputD:\notes\yuqueDOWNLOAD_IMAGE是否下载图片存到 images 子目录非必填默认 truefalseUPDATE_MDIMG_URL是否把文档内图片链接替换掉非必填默认 falsetrueREPLACE_IMAGE_HOST替换用的自定义图片主机对象存储/自建 CDN非必填默认为空https://img.example.com/最常用的组合是下载图片 替换为相对路径只需多设一个变量# Windows PowerShell下载图片并替换为相对路径 $env:UPDATE_MDIMG_URLtrue; python .\export-image.py# macOS / Linux效果相同 export UPDATE_MDIMG_URLtrue python3 export-image.py如果你图片已放在自建 CDN 上可设DOWNLOAD_IMAGEfalse并配上REPLACE_IMAGE_HOST只换链接不下载。脚本每处理一张图会打印Downloaded: xxx.png跑完后 Markdown 和图片就是一个完全自包含、可以搬走的包。语雀导出排错速查4 个高频问题1. 报错 Could not find Chromium原因Puppeteer 找不到浏览器可执行文件。解决确认已安装 Chrome 或 Edge仍失败则打开 main.js把puppeteer.launch({ headless: true })改为puppeteer.launch({ headless: true, executablePath: C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe })换成你本机的浏览器路径。2. 提示登录失效要求重新输入凭据原因cookies.json里的登录态过期了。解决删除项目根目录的cookies.json再用 USER PASSWORD 重新执行一次导出命令即可。3. 图片路径替换不生效链接还是指向语雀原因没设UPDATE_MDIMG_URLtrue或文档里的图片 URL 不是语雀标准格式脚本无法识别会跳过并打印 Warning。解决留意脚本输出的警告行只对标准语雀图片链接的文档重跑纯表格/思维导图类文档官方也不支持导出 Markdown需手动处理。4. 团队知识库导出失败原因团队空间导出场景工具未完整验证部分知识库需要团队管理员权限。解决先在语雀网页端手动导出该团队的一篇文档验证权限确认有权限后再跑批量导出。⚠️ 语雀官方 API 变更后工具可能失效遇到大面积失败时可对照项目更新说明检查。其他问题可查阅项目 GitHub 文档或直接提交 Issue 反馈。【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考