Markdown一鍵變精美電子書：自動封面+目錄+圖片下載，兼容微信讀書
整理版優先睇
呢個開源工具可以一鍵將 Markdown 變成專業 EPUB 電子書，自動處理封面、目錄同圖片下載，仲支援批量轉換。
呢篇文章係介紹一個由前字節大佬開源嘅 Python 項目 qiaomu-epub-book-generator。作者想解決嘅問題係：好多用 Word 或者 Google Docs 排電子書嘅人，成日遇到圖片消失、代碼塊變形、目錄要手動加等麻煩。呢個工具嘅整體結論係：一條命令就可以自動完成封面、目錄、圖片下載同格式轉換，仲可以配合其他工具做到出版級 PDF 輸出。
工具嘅核心功能包括圖片三連處理（自動下載遠程圖片、SVG 轉 PNG、大圖壓縮）、代碼塊完整渲染、表格同列表保持結構、自動封面（6 種主題）、自動目錄同元數據。作者仲分享咗一條更完整嘅鏈路：Markdown → EPUB → 在線轉換器 → Markdown → any2pdf → PDF，適合需要正式打印或傳閲嘅場景。成個鏈路用四個免費工具各司其職，等讀者可以由零開始整理知識合集。
- qiaomu-epub-book-generator 可以一鍵將 Markdown 轉成 EPUB，自動處理封面、目錄、圖片，解決手動排版嘅痛點。
- 安裝只需一句 npx skills add，生成命令指定輸入文件夾同輸出 epub 路徑，支援 --theme 等參數。
- 比起 Calibre 等通用工具，呢個項目專門處理 markdown 轉 epub 嘅細節，例如圖片下載、代碼塊高亮、嵌套列表等。
- 透過四個工具鏈路（Markdown→EPUB→PDF）可以做到出版級輸出，唔需要複雜嘅排版軟件。
- 如果你有大量 Markdown 文章想整理成電子書，可以用呢個工具批量生成；如果需要精美 PDF，再配合 any2pdf。
GitHub 開源地址
qiaomu-epub-book-generator 原始碼同說明文檔
樣例電子書（飛書文檔）
作者製作嘅 EPUB 樣例，可以睇到實際效果
在線 EPUB 閲讀器
瀏覽器直接開啟 EPUB 文件，唔需要安裝任何軟件
用 Word 排電子書，到底有幾痛？
好多人用 Word 或者 Google Docs 排電子書，成日遇到三個問題：圖片全丟——原文用嘅係遠程圖片連結，Word 唔會幫你下載；代碼塊變形——複製過去縮進冇咗，語法高亮冇咗，變成一坨看唔出結構嘅純文本；目錄要手動加——一篇文章係咁，二十篇就做到癲。
- 圖片全丟：遠程圖片連結唔會自動下載，要逐張手動保存再插入。
- 代碼塊變形：縮進、語法高亮全部消失，技術內容完全睇唔到。
- 目錄手動加：Word 嘅目錄功能唔識自動對應 Markdown 標題，要一條條整。
呢個工具做咗啲乜？
qiaomu-epub-book-generator 專註解決 Markdown 轉 EPUB 嘅排版問題，有六個核心功能，全部都係自動化：
- 圖片三連處理：自動下載遠程圖片、SVG 轉 PNG、大圖壓縮 JPEG，一條命令搞掂。
- 代碼塊完整渲染：Python、JavaScript、Go 等語言嘅代碼塊連語法高亮一齊塞入 EPUB，唔會變形。
- 表格同列表不走樣：嵌套列表嘅層級會保留，唔會打平。
- 自動封面：6 種主題揀——tech、business、design、literature、science、personal，SVG 矢量渲染，唔使自己整圖。
- 自動目錄：根據 Markdown 標題層級自動生成 TOC。
- 元數據設定：標題、作者、日期全部可以喺命令行指定。
一行命令，由零到書
安裝好簡單，直接用 npm 加 skill：
npx skills add joeseesun/qiaomu-epub-book-generator核心腳本係 scripts/gen_epub_enhanced.py，依賴 ebooklib 同 Playwright。安裝完之後用呢條命令生成：
python3 gen_epub_enhanced.py ~/my-articles ~/output.epub \
--title "我的知識合集" \
--author "你的名字" \
--cover-svg --theme tech~/my-articles 放你啲 Markdown 文件，支援成個資料夾批量處理。--theme tech 係科技主題，技術類內容推薦用呢個。
由 EPUB 到 PDF：完整出版級鏈路
生成 EPUB 之後有三種睇法：
- 在線睇：用 https://cn.online-reader.com/epub-reader 直接拖入瀏覽器，唔使安裝。
- 本地管理：Calibre 係電子書界嘅瑞士軍刀，免費、支援簡體中文，最新版 9.6.0 可喺 calibre-ebook.com 下載。
- 手機端：傳入手機用微信讀書打開，支援書籤、劃線、社交分享，對微信生態最順滑。
如果你需要正式打印或者傳閲，EPUB 就唔夠。作者提供咗一條更完整嘅鏈路：Markdown → EPUB → 在線格式轉換器 → Markdown → any2pdf → PDF。呢條鏈路用 four 個免費工具各司其職。
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 playwright
playwright 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來做電子書基礎內容的一個原因。
-另外一個原因是它可以實現
- 至於，用any2pdf嘅原因，就係佢可以實現出版級嘅pdf精美排版。
如果你只係臨時轉換，騰訊元寶都可以做格式轉換呢個嘢。但「格式轉換」同「精美排版」係兩回事。any2pdf解決嘅係後者。
呢條鏈路適合咩場景？需要打印、需要俾人發一份正式文檔、或者單純覺得「電子書喺電腦睇唔夠體面」嘅時候。
四個免費工具，一條完整鏈路
回頭睇成條鏈路，其實就係四個工具各司其職：
收藏夾入面嗰啲「改日整理」嘅文章，今日可能真係可以整理啦。
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 playwright
playwright 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來做電子書基礎內容的一個原因。
-另外一個原因是它可以實現
- 至於，使用any2pdf的原因，就是它可以實現出版級的pdf精美排版。
如果你只是臨時轉換，騰訊元寶也能幹格式轉換這活兒。但"格式轉換"和"精美排版"是兩件事。any2pdf解決的是後者。
這條鏈路適合什麼場景？需要打印、需要給別人發一份正式文檔、或者單純覺得"電子書在電腦上看不夠體面"的時候。
四個免費工具，一條完整鏈路
回頭看整條鏈路，其實就是四個工具各司其職：
收藏夾裏那些"改天整理"的文章，今天可能真的能整理了。