EPUB转Markdown

技能标识：epub-to-markdown

Convert EPUB books into an AI-ready Markdown library with a first-read META.md navigation index, per-chapter Markdown files, and extracted images. Use when the user wants to turn a .epub into Markdown for reading, summarization, analysis, retrieval, or downstream text processing, especially when the book should be explored chapter-by-chapter without loading the entire text at once.

作者：admin | 来源记录：ClawHub

EPUB 转 Markdown

使用内置脚本将 EPUB 转换为结构化的 Markdown 工作区。

运行

bash
uv run scripts/convert.py [output_dir]

- 省略 outputdir 时，将在 EPUB 所在目录旁生成 {epubstem}/ 文件夹。
如果 output_dir 已存在，脚本会停止运行而非删除该目录。
仅在用户明确要求替换已有生成目录时，才使用 --overwrite 参数。
依赖项已在脚本内声明，因此首次运行时 uv run 会自动安装。

输出

text
{output_dir}/
├── META.md
├── images/
└── chapters/
├── 001_{slug}.md
├── 002_{slug}.md
└── ...

- 请先阅读 META.md。该文件包含书籍元数据、总章节数和总字数，以及指向生成文件的章节索引。
仅当用户询问具体内容时，才读取 chapters/ 中的文件。

回复格式

转换成功后，报告如下信息：

text
✅ 转换完成

标题 : {title}
作者 : {authors}
章节数 : {total_chapters}
字数 : {total_words}
输出目录: {output_dir}/

如果章节标题显示异常、目录不完整，或用户需要边缘情况的行为细节，请阅读 references/reference.md。

EPUB转Markdown