
yuque-exporter安装配置指南4步把语雀知识库批量导出为Markdown【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter如果你的语雀知识库里堆了几百篇文档想迁到别的笔记工具却发现官方只支持单篇导出Markdown手工一篇篇点简直劝退这篇文章就是帮你跑通 yuque-exporter 安装配置全流程的。跟着做10分钟内你就能看到整个知识库以Markdown形式落在本地适合准备迁移内容的开发者与会员用户。这个工具能帮你做什么yuque-exporter 基于 Puppeteer 驱动一个真实的无头浏览器模拟登录你的语雀账号按知识库目录逐篇抓取文档并保存为 Markdown失败还会自动重试。它干的就是把你从几百次点击里解放出来的活文档越多省的时间越夸张。按知识库目录结构批量导出 Markdown层级和线上一致单篇导出失败自动重试不会卡死整个流程把文档里的图片下载到本地Markdown 和图片一起打包改写 Markdown 中的图片链接方便接入你自己的对象存储5分钟完成yuque-exporter安装配置它只依赖三样东西Node.js 运行环境、一个 Chromium 系浏览器以及处理图片时才用到的 Python 3。环境项要求获取方式Node.js16 以上自带 npm官网下载对应系统安装包Chromium 系浏览器Chrome / Edge / Brave 任一系统应用商店或官网安装Python 33.7仅图片处理需要官网或系统包管理器yarnnpm 的替代品装一次即可npm 一条命令全局安装顺手把 npm 指到国内镜像后面装依赖会快很多终端显示 installed 即配置成功。npm install -g yarn --registryhttps://registry.npm.taobao.org4步跑通yuque-exporter安装配置环境就绪后整个流程就是拿到代码、装依赖、配变量、运行。把项目拉到本地在终端执行下面两条命令完成后当前目录下会多出一个 yuque-exporter 文件夹。git clone https://gitcode.com/gh_mirrors/yu/yuque-exporter.git cd yuque-exporter安装依赖装完 yarn 的话直接用yarn也行看到 install complete 之类的提示就说明 puppeteer 等依赖就绪了。npm install配置登录与导出变量登录信息通过环境变量传入第一次成功后会落地为 cookies.json下次再跑就不用带账号密码了。变量名作用是否必填示例值USER登录账号手机号首次必填13800000000PASSWORD登录密码首次必填你的密码EXPORT_PATH导出目录可省默认 ./output/path/to/export不同系统的设置方式合在这张表里设完在当前终端生效系统设置方式命令macOS / Linuxexportexport USERxxx export PASSWORDxxxWindows CMDsetset USERxxx set PASSWORDxxxWindows PowerShell$env:$env:USERxxx; $env:PASSWORDxxx 密码里带特殊字符时macOS / Linux 下建议用单引号包住。运行第一次导出puppeteer 会拉起无头浏览器完成登录然后开始逐库抓取。看到Login successfully!且日志持续滚动就说明导出进行中结束后去 output 目录核对 .md 文件是否齐全。node main.js进阶图片处理与对象存储改写默认流程只产出 Markdown 文件文档里的图片还挂在语雀 CDN 上想让图片跟着走用自带的 export-image.py 对已导出的文件再跑一遍即可。变量名作用默认值MARKDOWN_DIRMarkdown 文件夹位置./outputDOWNLOAD_IMAGE是否下载图片到 images/ 子目录trueUPDATE_MDIMG_URL是否改写 md 内图片链接为相对路径falseREPLACE_IMAGE_HOST改写目标域名格式为 {域名}/{年}/{文件名}空如果图片已经自己传到了对象存储、只想要链接指向自家域名就把下载关掉、改写打开一行命令搞定跑完 md 里的图片路径会整体换掉DOWNLOAD_IMAGEfalse UPDATE_MDIMG_URLtrue REPLACE_IMAGE_HOSThttps://cdn.example.com/ python export-image.py常见坑与快速修复⚠️ 问题基本集中在这三类对号入座即可。现象报Could not find Chromium但明明装了浏览器 →解法在 main.js 的puppeteer.launch里加executablePath手动指定本机 Chrome 或 Edge 的可执行文件路径。现象某几篇文档导出超时、卡在 timeout →解法纯表格、思维导图类内容官方本身就不支持导出为 Markdown确认一下后手动导出即可不影响其他文档。现象python export-image.py 报缺少模块 →解法pip install requests补上依赖再重跑。到这里你的语雀知识库应该已经变成本地 output 目录里一棵整齐的 Markdown 树了。后续若因官方接口调整出现新报错直接翻项目仓库的最新动态和 Issue 列表通常都有现成答案。【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考