用 KOReader 看書的人大概都有同樣的經驗：讀到好段落就順手畫個重點、寫個筆記，但讀完之後呢？這些標註就一直留在閱讀器裡，再也沒打開過。

我自己用 Obsidian 管理所有筆記，一直想把 KOReader 的 highlight 也整合進來，卻找不到現成的工具。手動複製貼上太慢，寫腳本又要處理 KOReader 那套 Lua 格式的 metadata。

所以我寫了 KOHi，一個 Obsidian plugin，專門解決這件事。

KOHi 做什麼

USB 接上閱讀器，在 Obsidian 裡執行一個指令，就能把 KOReader 的 highlight 和筆記匯入 vault。每本書產生一份 Markdown 筆記，包含書籍資訊和所有標註。

核心功能：

• 自動偵測儲存模式 — KOReader 有三種存放 metadata 的方式（book folder / koreader/docsettings / koreader/hashdocsettings），KOHi 全部支援，不用自己去找檔案在哪裡。
• 模板自訂 — 產生的筆記格式完全可控。用 Nunjucks 模板語法，可以自訂 frontmatter、章節分組、頁碼、highlight 顏色等所有欄位。也提供預設模板，不想自己寫也能直接用。
• 選擇性匯入 — 可以一次匯入全部，也可以用模糊搜尋挑特定幾本書。
• 重複匯入覆蓋 — 重新匯入同一本書時，可以選擇是否要自動覆蓋舊筆記，不會產生重複檔案。

我在 KOBO 電子書閱讀器上額外安裝了 KOReader 系統，它的眾多設定讓我可以調整出自己最喜歡的樣子來觀看電子書，無論是 ePUB、PDF、CBZ 格式，高度自訂化佈局讓閱讀成為一件舒服的事。

最近有一個困擾我的地方，就是它的書本排序方式雖然很多，但卻沒有我想要的排序方式，我想要讓書本「先按照作者排序，然後如果是系列套書就按照系列順序排序，最後再按照書名或是出版日期排序」，這樣才符合我整理書本的習慣。

還好 KOReader 提供了讓使用者開發與安裝 user patch 的功能，那就自己來寫一個 patch 滿足我的需求吧！

p.s.: 也有開發者搜集了很多實用的 user patch，可以來這裡看看！