如何将语雀文档一键导出为电子书？yuque2book 完整使用指南

想把语雀上的知识库变成离线可阅读的电子书？试试 yuque2book 这款免费开源工具！它能帮你轻松将语雀文档库转换为 HTML 或 PDF 格式，让知识管理和分享更简单高效。

📌 什么是 yuque2book？

yuque2book 是一款专为语雀用户设计的文档导出工具，支持将在线文档库转换为本地电子书格式。无论是需要离线阅读、打印存档，还是分享给团队，它都能快速搞定，让你的知识管理效率提升 3 倍！

✨ 核心功能亮点

• 一键转换：输入语雀链接即可导出，无需复杂配置
• 多格式支持：生成 HTML 网页版或 PDF 电子书
• 本地化资源：自动下载图片和附件，告别网络依赖
• 完全免费：开源项目，无广告无付费功能

🚀 3 步快速上手 yuque2book

1️⃣ 安装准备

确保电脑已安装 Node.js，然后打开终端执行：

npm install yuque2book -g

2️⃣ 获取语雀 Token

1. 登录语雀账号，进入 个人设置 → 令牌管理
2. 点击"生成新令牌"，复制生成的 Token 字符串

3️⃣ 开始导出文档

yuque2book -t 你的令牌 https://www.yuque.com/你的知识库链接

例如：yuque2book -t abc123 https://www.yuque.com/yuque/help

📝 实用场景案例

案例 1：本地预览导出的文档

# 安装本地服务器工具
npm install anywhere -g

# 进入导出文件夹并启动预览
cd yuque_help && anywhere

此时浏览器会自动打开预览页面，效果如下：

图：yuque2book 导出的 HTML 文档本地预览效果

案例 2：导出带图片的完整文档

使用 -l 参数可自动下载所有图片：

yuque2book -t 你的令牌 -l https://www.yuque.com/知识库链接

🎥 操作流程演示

下面的动图展示了从安装到导出的完整过程：

图：yuque2book 导出语雀文档的动态演示

⚙️ 高级参数说明

参数	作用	示例
-t	指定语雀令牌	-t abc123
-l	本地化图片附件	-l
-h	查看帮助信息	-h

🔍 常见问题解答

Q：导出失败提示"Token 无效"怎么办？

A：检查令牌是否过期，建议重新生成并复制最新 Token。

Q：能否导出为 PDF 格式？

A：目前支持先导出 HTML，再通过浏览器"打印为 PDF"功能实现。

📚 相关工具推荐

• yuque-cli：语雀官方命令行工具
• yuque2md：专注 Markdown 格式转换
• yuque2epub：生成电子书阅读器支持的 EPUB 格式

项目源码地址：src/index.ts
本地化工具模块：src/lib/localize.ts

💡 使用小贴士

• 大型知识库建议分批导出，避免超时
• 导出前清理语雀文档中的冗余内容
• 定期更新工具获取新功能：npm update yuque2book -g

现在就用 yuque2book 把你的语雀知识库变成随身电子书吧！如有问题欢迎在项目 Issues 反馈。