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

匯入後的筆記長什麼樣

假設你讀了一本書，畫了一些重點，匯入後會產生這樣的 Markdown 筆記：

---
title: "原子習慣"
author: "James Clear"
language: zh
pages: 320
imported: 2026-05-01
---

## 第一章 原子習慣的驚人力量

> 習慣是自我改善的複利。
>
> — p.16

> 如果你每天都能進步百分之一，一年後你會進步三十七倍。
>
> — p.18

> [!note]
> 這跟投資的複利概念一樣，重點不是單次的幅度，而是持續性。

標註按章節分組，包含頁碼，你寫的筆記會以 callout 形式呈現。所有格式都可以透過模板調整。

安裝方式

KOHi 目前還在 Obsidian Community Plugins 的審核中，暫時可以用以下方式安裝。

透過 BRAT（推薦）

BRAT 是一個專門用來安裝尚未上架的 Obsidian plugin 的工具。

  1. 在 Obsidian 的 Community Plugins 裡搜尋並安裝 BRAT
  2. 進入 BRAT 設定 → Add Beta Plugin → 貼上 chiahsien/obsidian-kohi
  3. 回到 Community Plugins 列表，啟用 KOHi

手動安裝

  1. 從 GitHub Releases 下載 main.js、manifest.json、styles.css
  2. 在 vault 裡建立 .obsidian/plugins/kohi/ 資料夾
  3. 把下載的檔案放進去
  4. 重啟 Obsidian，在 Community Plugins 裡啟用 KOHi

設定與使用

設定 說明 預設值
Mount path 閱讀器的掛載路徑 —
Output folder 筆記輸出到 vault 的哪個資料夾 KOReader Highlights
Filename template 檔名格式，支援 {{title}}、{{author}} 等變數 {{title}}
Overwrite existing 重複匯入時是否覆蓋 開啟

設定完成後，打開 Command Palette，執行：

  • KOHi: Import all highlights — 匯入所有書籍的標註
  • KOHi: Import selected highlights — 用模糊搜尋選擇特定書籍

筆記會出現在你設定的 output folder 裡。

連結

歡迎試用。有問題或建議可以直接到 GitHub 開 issue，或是在這裡留言。