模型 / 資料集
pbek/QOwnNotes avatar
pbek/QOwnNotes

QOwnNotes:把筆記留在自己硬碟上的 Qt 桌面編輯器

QOwnNotes is a plain-text file notepad and todo-list manager with Markdown support and Nextcloud / ownCloud integration.

5,876 個 Star501 個 ForkC++GPL-2.0

秒懂

它是什麼?
QOwnNotes 是一套以 C++ 與 Qt 寫成的純文字筆記與待辦清單工具,透過 Nextcloud 或 ownCloud 的檔案同步把 Markdown 檔帶到手機。它的價值在於不引入專有資料庫,代價是你得自己維護同步與伺服器端外掛。
適合誰用?
如果你已經在用 Nextcloud 或 ownCloud,而且希望筆記就是硬碟上一批可被 grep 的 .md 檔,QOwnNotes 值得先裝來試;如果你要的是多人即時協作、行動裝置原生編輯體驗,或不想碰伺服器端外掛,它會讓你失望。動手前先確認三件事:你的伺服器是否裝了 QOwnNotesAPI(版本還原與垃圾桶功能取決於它)、筆記資料夾的同步方式是否會讓外部改動與編輯器互相覆蓋、以及你能否接受 GPL-2.0 對再散布的拘束。
可以商用嗎?
可以,但有條件。GPL-2.0 是 copyleft 授權:如果你散布包含它的軟體,就必須以同一授權公開該軟體的原始碼。只在內部執行、不對外散布,則不會觸發這項義務。
還在維護嗎?
有在維護。儲存庫最近一次提交在 1 天前。
用什麼語言寫的?
主要是 C++(依據 GitHub 的語言統計)。

以上回答依據專案的 GitHub 資料(最近同步於 2026年9月15日)與我們的分析,不構成法律意見。

開源專案深度解析

它解決的是檔案所有權,不是編輯體驗

多數筆記軟體把內容放進自家資料庫,匯出是事後補救。QOwnNotes 反過來:筆記從頭到尾就是磁碟上的純文字 Markdown 檔,README 的說法是「notes are stored as plain text markdown files」,同步交給 Nextcloud、ownCloud 的檔案同步機制,或 Syncthing、Dropbox 這類工具。這個選擇直接決定了它的適用對象。你必須先有一個你信任的檔案同步層,而且願意讓那個同步層決定衝突怎麼解。

目標使用者輪廓相當清楚:已經自架 Nextcloud 或 ownCloud、在意資料留在自己機器上、平常就在寫 Markdown 的人。README 明說「you can use your existing text or markdown files, no need for an import most of the time」,也就是說它不打算當你的資料倉庫,而是當你既有檔案堆的編輯前端。反過來說,如果你沒有自架服務、也不打算學同步工具,這個專案的前置成本會落在你身上。

C++ 與 Qt 換來的是記憶體,不是外掛生態

README 把「written in C++ and optimized for low resource consumption (no CPU and memory-hungry Electron app)」放在功能列表第一條,語氣很直白。這是一個明確的取捨:原生 Qt 應用在啟動速度與常駐記憶體上通常比 Electron 桌面程式收斂,但代價是擴充方式完全不同。QOwnNotes 沒有 npm 生態,它給的是 script repository,讓你在應用程式內安裝腳本,另外內建 AI 支援並以腳本整合 OpenAI、Groq 這類供應商,還附一個內建 MCP server 讓外部 AI agent 搜尋與取用筆記。

這裡要說清楚:我沒有安裝或執行過這個專案,上述都來自 README 的描述。README 沒有給出可對照的記憶體數字,也沒有說明腳本 API 的穩定程度,所以「低資源消耗」目前只能當成作者自述的設計目標,而不是可驗證的結論。真正該問的是你的腳本需求有多深:如果只是想在存檔時跑個格式化,腳本夠用;如果你需要一套成熟、有型別、有版本約束的擴充介面,這個專案不會給你。

筆記如何從編輯器走到手機

資料流本身不複雜。你指定一個或多個筆記資料夾,QOwnNotes 直接讀寫其中的 Markdown 檔;伺服器端的 Nextcloud 或 ownCloud 只負責搬檔案,不負責解析筆記格式。手機端則由 Nextcloud Notes for Android、iOS 的 CloudNotes,或 Markor 這類編輯器接手同一批檔案。README 也提到可以用 Synchronize Ultimate、FolderSync 之類的同步工具繞過官方 App,改用 WebDAV 或純檔案同步。

真正需要伺服器配合的是線上功能。筆記的版本還原與垃圾桶存取要靠 QOwnNotesAPI 這個 Nextcloud 或 ownCloud 應用程式,README 寫得很明確:「older versions of your notes can be restored from your Nextcloud / ownCloud server (install QOwnNotesAPI on your server)」。待辦清單要在網頁與手機上管理,則需要另外安裝 Tasks 後端。也就是說,桌面端的核心編輯不需要伺服器外掛,但你在網頁或手機上想看到的進階功能會需要。這條界線值得先畫清楚,否則裝完才發現版本還原按不下去。

編輯器本身對外部改動有處理:README 說它會監看筆記檔的變更,重新載入筆記或筆記清單,並在目前筆記與外部變更版本有差異時以對話框顯示。這是純檔案同步架構的必要設計,因為衝突幾乎必然發生。

安裝與設定:從套件到 API 外掛

README 沒有在正文內列出安裝指令,只把安裝導向官方網站的安裝頁面,因此這裡不編造任何指令。可確認的散佈管道包括 Snap(README 有 Snapcraft 狀態徽章)、Windows 的 AppVeyor 建置,以及 GitHub Actions 的建置流程。實際安裝步驟請以官方安裝頁面為準。

設定面上,README 提到的具體項目有幾個:多個筆記資料夾可同時使用、筆記本機垃圾桶與系統垃圾桶兩種模式、可自訂鍵盤快速鍵(並支援 Wayland 全域快速鍵)、拼字檢查,以及選配的 LanguageTool 與 Harper 文法檢查、Markdown LSP 支援(例如 Marksman 提供補全與診斷,Rumdl 用於 lint)。另外有選配的 wiki 風格連結,語法是 `[[Note]]`,附自動補全、標題錨點、別名、反向連結與重構支援。

伺服器端要準備的則是三件事:檔案同步本身、QOwnNotesAPI 應用程式(版本與垃圾桶)、以及 Tasks 後端(待辦清單)。這三項各自是獨立的安裝步驟,README 把它們分開列出,代表它們不是同一個套件。

同步衝突是這個架構的固有風險

純檔案同步的設計有一個無法迴避的失敗模式:同一個檔案在兩台裝置上被改。QOwnNotes 在桌面端用對話框顯示差異,讓你能看到外部變更,但這只覆蓋桌面端察覺到的情況。手機端編輯器、同步工具與伺服器之間怎麼合併,取決於你選的同步方案,不是 QOwnNotes 能控制的範圍。README 對此沒有描述衝突解決策略,只描述了變更監看與差異顯示。

另一個容易被忽略的邊界是功能不對稱。你在桌面上看到的版本還原與垃圾桶,前提是伺服器裝了 QOwnNotesAPI;沒裝的話,這兩個功能不存在。而 Nextcloud Notes 或 ownCloud Notes 的網頁介面能呈現的欄位,也不等於 QOwnNotes 桌面端能呈現的全部。選用這套工具時,實際上是在接受一個由多個獨立元件拼起來的系統,每個元件的版本與能力都要自己對齊。

與 Obsidian、Joplin 的取徑差異

同樣處理本機 Markdown 檔,Obsidian 走的是另一條路:它以本地資料庫索引整個 vault,提供外掛生態與圖譜檢視,同步則交給付費服務或第三方。QOwnNotes 不建索引層,直接把 Nextcloud 或 ownCloud 當成同步與線上功能的來源,並以伺服器端外掛補上版本與垃圾桶。差別在於誰負責狀態:Obsidian 由應用程式維護,QOwnNotes 由檔案系統與伺服器維護。前者功能整合度高,後者對資料的控制更透明。

Joplin 則是資料庫優先,匯出 Markdown 是輔助手段,並自帶同步後端。如果你要的是開箱即用的同步與行動 App,Joplin 的整合度更好;如果你要的是檔案就是唯一真相,QOwnNotes 的模型更直接。真正的判斷點是:你願不願意為了「檔案即資料」承擔同步衝突與外掛安裝的維運成本。

授權與維護:GPL-2.0 與持續建置的節奏

專案以 GPL-2.0 釋出。這是 copyleft 授權,如果你打算把 QOwnNotes 的程式碼併入自己的產品再散布,會受到授權條款的拘束;單純安裝使用不受影響。這裡不構成法律意見,涉及商業再散布時請自行確認條款或諮詢專業。

維護節奏可以從發布紀錄看出:v26.9.1、v26.9.2 分別在 2026 年 9 月 4 日與 9 月 7 日發布,另有一條 continuous 持續建置在 9 月 8 日。這種密集的版本節奏通常代表專案活躍,但也意味著升級頻率高。對採用者來說,實際成本不在授權費,而在於你的腳本、快速鍵設定與伺服器端外掛要跟著版本走。README 沒有提供穩定的 LTS 分支或長期支援承諾,這是評估時應該自行確認的一點。

編輯結論

如果你已經在用 Nextcloud 或 ownCloud,而且希望筆記就是硬碟上一批可被 grep 的 .md 檔,QOwnNotes 值得先裝來試;如果你要的是多人即時協作、行動裝置原生編輯體驗,或不想碰伺服器端外掛,它會讓你失望。動手前先確認三件事:你的伺服器是否裝了 QOwnNotesAPI(版本還原與垃圾桶功能取決於它)、筆記資料夾的同步方式是否會讓外部改動與編輯器互相覆蓋、以及你能否接受 GPL-2.0 對再散布的拘束。這三項沒確認前,不要把它當成團隊知識庫的底層。

官方來源

  1. License: GPL-2.0
  2. pbek/QOwnNotes on GitHub
  3. Project website
  4. README
  5. Releases
社群筆記

社群筆記