如何快速导出语雀文档？免费开源的yuque-exporter工具完整指南

1、什么是yuque-exporter？

yuque-exporter是一款免费开源的语雀文档导出工具，能够帮助用户将语雀平台的文档批量导出为本地Markdown文件。当语雀调整付费策略后，这款工具成为了免费用户迁移文档的理想选择，让你的知识库不再受平台限制。

2、准备工作：安装必要环境

2.1 安装Node.js环境

yuque-exporter基于Node.js开发，首先需要确保你的系统中安装了Node.js和npm。打开终端输入以下命令检查是否已安装：

node -v
npm -v

如果没有输出版本号，请前往Node.js官网下载并安装适合你系统的版本。

2.2 安装Git工具

为了获取项目源码，你需要安装Git版本控制工具。同样在终端中检查：

git --version

如未安装，请从Git官方网站下载并安装对应系统的版本。

3、3步快速安装yuque-exporter

3.1 克隆项目仓库

打开终端，执行以下命令克隆项目源码：

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

3.2 进入项目目录

克隆完成后，使用cd命令进入项目文件夹：

cd yuque-exporter

3.3 安装项目依赖

执行npm install命令安装所需依赖包：

npm install

4、获取语雀API Token

要使用工具导出文档，你需要语雀的API Token。登录语雀后，进入个人设置→API令牌，创建并复制你的令牌。

5、开始导出语雀文档

一切准备就绪后，在终端中运行以下命令开始导出：

YUQUE_TOKEN=<你的令牌> npm start

将<你的令牌>替换为你从语雀获取的实际API令牌。工具将自动开始抓取并导出你的语雀文档。

6、导出文件存放位置

导出的Markdown文件默认存放在项目的src/lib/目录下，你可以通过修改配置文件自定义输出路径。

7、常见问题解决

7.1 导出过程中断

如果导出过程意外中断，可以重新执行导出命令，工具会自动跳过已导出的文件，继续未完成的任务。

7.2 中文乱码问题

确保你的系统环境编码为UTF-8，通常现代操作系统默认支持，但如果遇到乱码，可以在终端中执行：

export LANG=en_US.UTF-8

8、总结

通过yuque-exporter，你可以轻松将语雀文档导出为本地Markdown文件，实现知识库的自主管理。这款工具完全免费开源，代码托管在src/目录下，有开发能力的用户还可以根据需求进行二次开发。

无论是个人用户还是团队，yuque-exporter都能帮助你快速、安全地迁移语雀文档，让知识资产真正属于你自己！