Markdown一键变精美电子书:自动封面+目录+图片下载,兼容微信读书

GitHub上有个前字节大佬开源的Python项目，功能极其聚焦——一句话，把Markdown变成专业EPUB电子书。

叫 qiaomu-epub-book-generator。

你可能觉得"转个格式而已，Calibre不就能干？"能干，但不干脏活。Calibre只管格式转换，图片丢不丢、代码块歪不歪、封面有没有——它不负责。这个项目负责。

用Word排电子书，到底哪里痛

用Word或者Google Docs排电子书的人，大概率经历过这些事：

从博客导出一篇文章，粘贴到Word里，图片全丢了——因为原文用的是远程图片链接，Word不会帮你下载。代码块更惨，复制过来直接变形，缩进没了，语法高亮没了，变成一坨看不出结构的纯文本。好不容易手动调好格式，发现目录要一条一条加。

一篇文章就这样，二十篇呢？

qiaomu-epub-book-generator 解决的就是这些问题。而且是全自动的。

这个工具到底干了什么

功能拆开说。

图片三连处理。 自动下载远程图片，SVG转PNG，大图压缩成JPEG。每一步单独看都不复杂，手动做一遍就知道了——二十篇文章，光图片就能耗掉你一整个晚上。这个脚本一条命令全搞定。

代码块完整渲染。 技术内容排版最翻车的环节。Markdown里的代码块连带语法高亮一起塞进EPUB，Python、JavaScript、Go都支持，不会变成一坨没结构的纯文本。

表格和列表不走样。 很多转换工具会把嵌套列表的层级打平。这个不会。

自动封面。 6种主题可选——tech、business、design、literature、science、personal，SVG矢量渲染，不用你自己准备图片。

自动目录+元数据。 标题、作者、日期，命令行参数指定。TOC根据Markdown标题层级自动生成。

六个功能，一个命令。

一行命令，从零到书

安装方式很简洁：

npx skills add joeseesun/qiaomu-epub-book-generator

核心脚本在 scripts/gen_epub_enhanced.py，依赖两个东西：ebooklib（EPUB生成库）和 Playwright（用来渲染SVG封面）。

生成命令：

python3 gen_epub_enhanced.py ~/my-articles ~/output.epub \  --title "我的知识合集" \  --author "你的名字" \  --cover-svg --theme tech

~/my-articles 放你的Markdown文件，支持整个文件夹批量处理。--theme tech 是封面主题，技术类内容推荐用这个。

踩坑提醒

有两点值得提前说。

必须装 Playwright + Chromium。 封面渲染依赖它，没装的话封面生成会直接报错。装一次就行：

pip install playwrightplaywright install chromium

远程图片下载可能失败。 如果原文引用的图床挂了或者链接失效，图片就下不来。这种情况下脚本会跳过，不会中断整个生成流程。生成完之后检查一遍EPUB，补上缺失的图片再重新跑一次就行。

也可以手动下载下来到AI客户端skills跟目录下，然后在客户端里用自然语言调用这个技能并测试。

开源地址：

https://github.com/joeseesun/qiaomu-epub-book-generator

作者自己做的电子书样例可以在这里看效果：

https://xiangyangqiaomu.feishu.cn/wiki/TNfWw8lICidMCLkQG9CcTlprngc

生成之后，怎么看

EPUB文件有了，接下来是阅读环节。三条路：

在线看。 浏览器直接打开

https://cn.online-reader.com/epub-reader

把EPUB文件拖进去就能读，不用装任何东西。适合临时查看或者给别人分享。

本地管理。 Calibre 是电子书领域的瑞士军刀，免费，支持简体中文界面，能管理、转换、编辑EPUB，全球几千万用户。最新版 9.6.0，下载地址 ：calibre-ebook.com。

手机端。 把EPUB传到手机，用微信读书打开——支持书签、划线、社交分享。对微信生态用户来说，这条路径最顺滑。

进阶：EPUB不够，还要PDF

EPUB很好，但它有个现实问题：不是所有人都用电子书阅读器。你想打印一份、或者发给别人正式传阅的时候，PDF才是真正通用的格式。

这里有一条很多人不知道的完整链路：

Markdown → EPUB → 在线格式转换器 → Markdown → any2pdf → PDF

听起来绕，但每一步都有它的道理。EPUB转回Markdown是拿回干净的内容源，any2pdf（另一个开源项目）负责把这个Markdown渲染成排版精美的PDF——14种主题可选，CJK中英文混排，效果比直接"打印EPUB"好几个档次。

这里特别说明一下：

- Md直接转epub或者pdf格式的在线工具遍地都是，但是，开源市场没有一个是可以自动遍历全网资料生成主题电子书的。——这是我推荐使用qiaomu-epub-book-generator来做电子书基础内容的一个原因。

-另外一个原因是它可以实现