Markdown 转 EPUB 电子书

本词条以前被写成"解析和分析现有电子书的 EPUB 处理器"，这是错的。所链接的仓库 smerchek/claude-epub-skill（作者 Scott Smerchek，MIT）做的恰恰相反：它的 markdown-to-epub-converter Skill 把 Markdown 文本、Markdown 文件或聊天总结转换成 EPUB3 电子书，可在 Apple Books、Google Play 图书、Kobo、Kindle 应用或任何标准阅读器中打开。更新日志中的最新版本是 1.1.0（2025-10-17），我们在 2026-09-23 查看时，最后一次提交日期为 2025-10-18。

核心功能

• 自动结构：H1 标题成为章节，H2 到 H6 成为小节，并生成目录，同时提供 EPUB3 NAV 和兼容旧阅读器的 NCX 导航。
• 格式支持：粗体、斜体、链接、嵌套列表、引用块、分隔线，以及带样式表头和斑马纹的 Markdown 表格。
• 代码块：自 1.1.0 起，语法高亮改用 Pygments（支持 100 多种语言）并带行号，取代了早期的正则方案；该版本还修复了代码块中的注释被误当成章节标题的问题。
• 元数据：YAML front matter 可设置 title、author、language（默认 en）和 date；未设置标题时默认使用第一个 H1。
• 依赖精简：requirements.txt 中锁定了 ebooklib、markdown2 和 Pygments，并附带测试脚本，检查解析、生成和边界情况。

适用场景

• 在电子阅读器上阅读长篇研究笔记或 Claude 对话总结。
• 把系列博客或内部文档打包成一本离线电子书。
• PDF 显示效果差的设备上，阅读带代码的技术文档。

定价与获取

按仓库中的 MIT 许可免费使用。本地运行需要 Python 3.8+，生成 EPUB 不需要 API key，也不联网。

快速开始

1. 克隆仓库，运行 pip install -r markdown-to-epub/requirements.txt，再运行 python test_epub_skill.py 确认安装成功。
2. 在 Claude Code 中使用时，把 markdown-to-epub 文件夹复制到 ~/.claude/skills/；如需在别处上传 Skill，可用 publish.sh 打包成 zip。
3. 对 Claude 说："把 research_notes.md 转换成 EPUB 文件。"

局限：它不能读取、搜索或总结已有的 EPUB 文件，也不生成 Kindle 原生的 .mobi 或 .azw3（列在未来计划中），暂不生成封面图。项目自 2025 年 10 月以来没有新的开发。

常见问题

能分析我已有的 EPUB 吗？

不能。要从 EPUB 中提取文字，可以用 MarkItDown，它支持 EPUB 输入。

为什么同一本书在不同阅读器上看起来不一样？

EPUB 阅读器会套用自己的字体和样式。项目说明中提到，结构会保留，但外观会因阅读器而异。

替代方案

• MarkItDown Skill：反方向转换，把包括 EPUB 在内的文档转成 Markdown。
• DOCX Skill：目标是 Word 文档而不是电子书时使用。
• PDF Skill：固定版式的 PDF，而不是可重排的 EPUB。

总结

Markdown to EPUB Converter 是一个小而专注的本地工具，把 Markdown 变成好读的电子书。它不是 EPUB 分析器，也不再积极开发，但用很少的依赖把这一件事做好了。更多文档工具见 Skills 分类。