KOHi — 把 KOReader 的閱讀標註匯入 Obsidian
2026-05-01
用 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 顏色等所有欄位。也提供預設模板,不想自己寫也能直接用。
- 選擇性匯入 — 可以一次匯入全部,也可以用模糊搜尋挑特定幾本書。
- 重複匯入覆蓋 — 重新匯入同一本書時,可以選擇是否要自動覆蓋舊筆記,不會產生重複檔案。