语雀文档批量导出神器：免费快速迁移你的知识库

【免费下载链接】yuque-exporter 项目地址: https://gitcode.com/gh_mirrors/yuqu/yuque-exporter

还在为语雀付费策略调整而烦恼吗？😟 想要快速将多年积累的文档迁移到本地或GitHub？yuque-exporter就是你需要的终极解决方案！这款强大的语雀文档导出工具能够一键批量导出所有文档，完美保留原有的目录结构和内容格式。

🚀 5分钟快速上手指南

环境准备与一键安装步骤

首先获取项目代码：

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

获取语雀Token的最快配置方法

使用yuque-exporter前，需要获取语雀API访问令牌：

1. 登录语雀官网
2. 进入"个人设置" → "开发者管理"
3. 点击"生成新Token"并妥善保存

💡 核心功能深度解析

智能文档爬取系统

yuque-exporter采用先进的API调用机制，实现高效文档批量获取：

• 自动识别用户信息和仓库列表
• 智能解析目录结构（TOC）
• 增量下载机制，避免重复工作
• 并发处理，默认10个线程同时下载

文件处理黑科技

导出的文档经过多重智能处理：

• 自动生成frontmatter元数据
• 下载并本地化所有图片资源
• 智能链接替换，确保本地可用
• HTML标签清理，保持Markdown纯净

🛠️ 实战操作手册

基础导出命令执行

设置环境变量并启动导出：

YUQUE_TOKEN=你的令牌 npm start

指定仓库精准导出

如果你只想导出特定知识库，可以修改配置：

// 在src/main.ts中指定目标仓库
const targetRepos = [
  '用户名/仓库名',
  // 添加更多仓库
];

📊 配置参数详解

核心配置项说明

在src/config.ts中，你可以找到以下关键配置：

export const config = {
  host: 'https://www.yuque.com',     // 语雀API地址
  token: process.env.YUQUE_TOKEN,   // 访问令牌
  outputDir: './storage',             // 输出目录
  clean: false,                       // 是否清理元数据
};

输出目录结构展示

storage/
├── .meta/           # 智能元数据管理
│   ├── username/    # 用户信息缓存
│   └── namespace/   # 仓库数据备份
└── output/          # 最终Markdown文件

🔧 故障排除与优化技巧

常见问题解决方案

Token认证失败 🔐

• 检查Token是否正确设置
• 确认Token具有足够权限
• 验证网络连接状态

中文文件名兼容性

• 确保系统支持中文路径
• 如有需要可手动调整文件名

⚡ 高级功能探索

批量处理性能优化

yuque-exporter支持并发下载，默认并发数为10。对于大型文档库，建议：

• 根据网络状况调整并发数
• 分批次导出不同仓库
• 利用增量更新功能

智能增量导出机制

工具会自动检测文档变更，只下载发生修改的文档，大幅提升效率！

🏗️ 技术架构揭秘

项目基于TypeScript开发，采用现代化技术栈：

• consola：优雅的日志输出
• fast-glob：高效文件匹配
• p-queue：智能任务队列
• remark：Markdown处理引擎

📝 使用注意事项

1. API调用限制：语雀API每小时限制5000次调用
2. 附件下载：由于权限限制，暂不支持附件下载
3. 多账号支持：团队文档功能正在积极开发中

现在就开始使用yuque-exporter，轻松迁移你的语雀知识库！✨ 无论是个人博客还是团队文档，都能快速完成本地化备份，让你的知识资产永远安全可控。

【免费下载链接】yuque-exporter 项目地址: https://gitcode.com/gh_mirrors/yuqu/yuque-exporter