支持的格式
ReadShell 目前支持三种格式：txt、epub、md。
导入用 novel import，传入目录时会递归扫描所有支持的文件。
支持哪些电子书格式？
| 格式 | 支持情况 | 导入时的行为 |
|---|---|---|
.txt | 支持 | 自动检测文件编码并转为 UTF-8（可处理 GBK 等常见编码）；按常见章节标题（第X章 / Chapter N 等）自动切分章节；书名取自文件名 |
.epub | 支持 | 读取 epub 元数据（书名、作者）与目录，按阅读顺序逐章提取正文 |
.md | 支持 | Markdown 文件按纯文本导入（不渲染排版），与 txt 走同一条解析管线，支持章节切分 |
txt 怎么导入？
直接指向文件或目录即可。ReadShell 会自动检测 txt 文件的编码
（UTF-8、GBK 等常见中文编码都可以），并扫描「第X章 / 第X回 / Chapter N」这类常见章节标题生成章节索引，
在阅读器里按 c 就能跳转。
novel import 三体.txt
novel import ~/books/ # 递归扫描目录里所有 txt / epub / mdepub 怎么导入？
直接导入即可。ReadShell 会读取 epub 的书名、作者元数据和目录结构，按阅读顺序逐章提取正文；
章节出现在阅读器的章节列表（c）中。
md（Markdown）能看吗？
能。.md 文件按纯文本导入——标题、列表等 Markdown 记号会原样显示，
不做排版渲染；章节切分规则与 txt 相同。适合读文档、笔记和纯文本稿件。
哪些格式不支持？
pdf、mobi、azw3、fb2 等格式目前不支持，
novel import 会跳过它们。如果只需要在终端读 epub，
也可以看看终端电子书阅读器对比里的其他开源工具。
下一步
- 安装 → npm 全局安装与环境要求
- 用法与快捷键 → 导入之后的命令与按键
- 终端电子书阅读器对比 → 各工具支持的格式一览
更新于 2026-10-10