刘寅生律师用过的 Markdown 笔记本不下六七个，从 Typora 到 Obsidian 再到各种 SaaS 笔记，最后留在 QOwnNotes 这个开源项目上，而且一用就是好几年。坦白说，第一眼看到它的界面，确实不像 Obsidian 那么惊艳，但如果你在意的是"笔记到底存在哪、谁有权限看、十年后还打不打得开"，QOwnNotes 会是一个值得认真考虑的选择。这篇就围绕 QOwnNotes v26.3.20 这个版本，把隐私设计、同步方案、脚本扩展、任务管理、迁移避坑这几个方面一次讲透。
1. 隐私优先这件事，QOwnNotes 到底做了多少
1.1 免费笔记工具的隐私真相
很多人觉得"我又不是什么大人物，笔记被看就被看了"，但现实是，笔记这类数据一旦进了别人的服务器，风险不是"被某个人看了"，而是"随时可能以你自己都想不到的方式被处理"。传统云笔记在你输入的时候，文本就通过网络传到服务端，服务端哪怕只做语法解析和搜索索引，也意味着你的原文曾经出现在别人可控的机器上。更麻烦的是，一旦账号体系出现漏洞，笔记内容可能成为黑客的目标，或者平台方改版后默认允许第三方接口访问你的数据。
QOwnNotes 的做法简单到有点"原始"：笔记就是本地 Markdown 文件，纯文本，不锁数据库，不加密存储默认，不强制注册账号。你用任何文本编辑器打开同一个文件夹，看到的还是那些 .md 文件。读取、修改、备份都完全掌握在你手里。这就是隐私优先的第一层：数据不经过任何中间服务器。
1.2 没有遥测，没有后门，代码可审查
第二层是"开源"。QOwnNotes 从桌面端到 Android 端都是开源项目，你可以在 GitHub 上看到完整源码。虽然"开源"并不能 100% 代表没有遥测，但至少你（或者社区里任何一个较真的人）能去查。从代码仓库和网络请求的实际行为看，它在默认情况下不会主动上报使用习惯，也不会像很多商业软件那样在后台发一堆统计埋点。这一点我用抓包工具验证过，装上到正常使用，除了你主动配置的同步服务，网络请求基本静默。
当然，隐私优先不等于"不能上网"。QOwnNotes 如果你接入了 Nextcloud 或者 WebDAV，它会把文件发到你自己的服务器；如果你用了内置的拼写检查、天气预报脚本，那也会产生对应请求。关键是"不默认送你到别人的服务器"和"所有同步目标都由你自己指定"。
提示：判断一个笔记工具是否隐私优先，最直接的方法就是看它能不能在完全断网环境下安装、运行、编辑、搜索。QOwnNotes 可以。这一步做不到的软件，再怎么喊隐私也是空话。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 同步方案与同步冲突处理：自己的服务器才是最稳的云端
2.1 Nextcloud 同步的配置细节
QOwnNotes 自带 Nextcloud 同步支持，这其实是它最被低估的功能之一。我用的配置非常简单：一台自己的服务器（不一定要高性能，树莓派或者云主机都行）跑好 Nextcloud，然后在 QOwnNotes 的设置里选中"Nextcloud 同步"，填入服务器地址、WebDAV 路径、账号密码或应用密码，选好同步间隔即可。
有个细节值得注意：同步的本质是文件复制，不是数据库合并。QOwnNotes 会把本地 notes 目录里的 .md 文件放到 WebDAV 的指定目录下，多端之间通过文件更新时间戳来判断差异。这意味着你不需要理解复杂的同步协议，也不用担心供应商锁定，哪怕是换一个笔记软件，只要它支持 WebDAV 或直接读取文件夹，你的笔记都能带走。
2.2 冲突文件是怎么产生和避免的
用本地文件加同步盘的方式，最常遇到的问题就是"冲突文件"。比如手机端改了标题，电脑端又没同步就改了正文，两边会各自生成一个带"冲突"字样的副本，或者变成一个 .conflict 文件。QOwnNotes 处理冲突的方式还算克制，它不会自动覆盖谁的版本，而是尽可能保留两个副本让你判断。后来我调整了使用习惯，基本没再碰到冲突：
- 手机端短暂记录，不要长按编辑已有笔记，写完了等同步完成再关应用；
- 电脑端写完文件后，保持 QOwnNotes 挂后台几分钟，让同步跑完；
- 删除操作尽量在同一个端完成，避免多端同时删改。
2.3 不用 Nextcloud，也能用 WebDAV 或纯本地
如果你对 Nextcloud 没兴趣，也可以用任意 WebDAV 服务。坚果云这类国内网盘的 WebDAV 接口我也试过，配置方式差不多，路径填对应子目录即可。如果连 WebDAV 都不想用，它完全可以当纯本地编辑器，配合坚果云盘、Syncthing 或者 iCloud 的本地目录来自动同步，效果也一样。
我个人的建议是：除非你已经搭好了 NAS 或服务器，否则不要为了同步而去学 Nextcloud 的运维。直接用具备 WebDAV 的网盘服务，或者甚至就靠 Git 仓库备份，对多数用户来说完全够用。QOwnNotes 不在这件事上强迫你。
3. Markdown 编辑体验：它的快捷键逻辑和写作习惯
3.1 预览模式、目录生成与常用快捷键
QOwnNotes 使用的是自研的 Markdown 渲染引擎，预览模式可以在编辑窗口右侧或单独标签里打开。默认的编辑按钮、标题级别快捷键和多数 Markdown 编辑器相近，但它有一个我很喜欢的小逻辑：快捷键按语义设计，而不是按功能堆。比如 Ctrl+Shift+1 到 6 是标题级别，Ctrl+Shift+B 是加粗，Ctrl+Shift+I 是斜体，Ctrl+Shift+K 是插入代码块。你不需要记忆工具图标的位置，手放在键盘上直接操作。
目录导航也很有意思。侧边栏的"笔记树"显示的是当前笔记文件列表，而笔记内部的标题结构，会显示在一个单独的"当前笔记导航"区域，点一下就能跳转。对于一篇几千字的笔记，这个导航比滚动查找舒服得多。它还支持脚注、任务列表、表格、图片内嵌这些常见语法，渲染效果干净，适合发布到多数博客平台。
3.2 相对路径与图片管理
图片粘贴是一个非常实用的功能。截图后直接 Ctrl+V，QOwnNotes 会默认把图片保存到当前笔记同目录下的一个文件夹里，并在 Markdown 中插入相对路径。这一点比很多在线笔记强，因为你的图片和 Markdown 文件永远在一起，整个目录打包备份即可。相对路径在本地迁移时也不会失效。如果你用 Typora 或 Obsidian 文件夹方式迁移过来，图片路径基本能兼容。
3.3 全文搜索与标签体系
全文搜索在本地 Markdown 工具里是最容易做得很难用的功能，因为纯文本没有索引往往意味着"慢"。QOwnNotes 的处理还算可以，它默认会建立文件系统缓存，首次搜索慢一些，后续搜索基本秒出。搜索结果会按笔记文件名、标题、内容分块展示。标签方面，它支持在笔记开头用 tags: 标签 这种形式定义标签，也可以在侧边栏按标签浏览，我个人习惯是在每个笔记头部维护几行元信息，用来做分类和检索。
提示：本地 Markdown 的搜索性能上限取决于目录里的文件数量和单文件体积，我的工作笔记目录有 2000 多个 .md 文件，搜索依然流畅。如果文件到了上万，建议开启"索引缓存"而非"实时扫描"。
4. 从纯编辑器到个人工作台：脚本引擎和命令面板
4.1 脚本引擎能干什么
QOwnNotes 不只是编辑器，它内置了一个脚本引擎，可以执行 JavaScript 脚本，并且脚本能访问当前笔记、选择的文本、标签、文件夹等数据。简单说，你可以自己写一个脚本，把当前选中的文字交给外部 API 翻译、生成摘要、插入时间戳，或者批量处理多个笔记的格式。
这有点像给笔记本装上了自动化管道。我写过一个脚本：把当前 Markdown 笔记里所有二级标题收集起来，生成一个带链接的目录，插入到文首；还写过另一个脚本，在保存时自动把中文字符之间的多余空格去掉。这种能力不是所有笔记软件都愿意开放的，也是我留下来的重要原因之一。
4.2 命令面板和外部工具配合
按 Ctrl+Shift+P 可以打开命令面板，在这个面板里你能快速访问所有功能，包括脚本。QOwnNotes 甚至可以直接调用外部命令，比如把当前笔记发到 pandoc 转成 docx，或者调用 git 提交。实际上，我把笔记目录变成了一个 Git 仓库，每次写完一个小结就手动在命令面板里跑一次保存脚本——提交、打标签、推送远程仓库。这样既有了版本历史，又不需要离开编辑器。
这几步配合起来，QOwnNotes 的使用体验从"一个 Markdown 编辑器"上升为"一个完全由自己控制的数据工作台"。你不需要接受任何平台对文件格式的限制，也不依赖任何云端 API。这也是我在多台设备之间无缝切换工作状态的真正原因。
5. 任务管理、加密笔记和移动端使用体验
5.1 任务清单与笔记内的任务状态
Markdown 任务语法是 - [ ] 和 - [x]，很多 Markdown 工具能写，但不会主动帮你管理"待办、已完成、任务清单概览"。QOwnNotes 做了一个有限但实用的设计：它会在侧边栏单独显示任务入口，汇总所有笔记中的未完成任务，并显示所在的笔记和上下文。点一下可以直接跳转。
这个功能我用了很久，后来甚至衍生出一个习惯：所有待办事项只写在笔记里，不单独开任务 App。因为任务和上下文放在一起，比孤立的任务列表更容易回忆。实际体验下来，任务多到需要依赖的截止日期和提醒时，它还是不够专业，但作为个人笔记场景内的轻量任务管理，已经足够。
5.2 笔记加密：不是默认，但支持
隐私优先不等于所有笔记都要加密。QOwnNotes 支持通过"内置的加密和解密"功能对单篇笔记进行加密，用的是经典对称加密算法，密码由你自己掌握。加密后的笔记会以密文形式存储在文件里，别人即使拿到文件也读不出明文。这个功能我一般只用在 token、服务器密码、身份证号这类敏感信息上。
需要提醒的是，加密笔记和同步功能的关系：如果你同步的是加密后的文件，那么服务器上存的是密文，安全性更高；但如果你在移动端打开加密笔记，则需要输入密码。每次打开都要输密码确实麻烦，但至少保证了"云端即使泄露，也无法直接读取笔记"。
5.3 Android 端与移动记录场景
QOwnNotes 有官方 Android 端，可以直接配合 Nextcloud 同步。移动端的编辑体验比桌面端简单，但它适合"快速记录灵感、查看笔记、打勾任务"这类场景。移动端的 Markdown 渲染不像桌面端那么丰富，表格和复杂格式偶尔会错位，这可以接受——毕竟谁也不会在手机上写一份几百行的技术文档。
6. 从 Obsidian 或 Typora 迁移过来的实际差异与避坑建议
6.1 与 Obsidian 的差异
Obsidian 能提供双向链接、关系图谱、插件生态，这些 QOwnNotes 没有。如果你大量依赖 Obsidian 的 [[双链]] 语法，会发现在 QOwnNotes 里这些只是普通文本，点击无法跳转。所以，如果你已经用 Obsidian 建立了复杂的双链网络，不建议强行迁移。但如果你只是用 Obsidian 做纯 Markdown 记录，那迁移成本很低，文件夹结构、md 文件内容基本原样保留。
6.2 与 Typora 的差异
Typora 的优点是实时渲染，所见即所得，这点比 QOwnNotes 编辑时的分割视图更流畅。但 Typora 在同步、任务管理、脚本扩展上几乎不提供原生方案。QOwnNotes 更适合我这种需要把笔记和自动化结合的人。刚切换时，我最大的不习惯就是"Markdown 语法需要实时预览才能看到效果"，用了两周后，这种顾虑很快就消失了，反而觉得实时预览和源码模式分开反而更专注。
6.3 迁移时的三条避坑建议
- 先统一图片资源。如果你原来用的是 Typora 默认的图片复制路径，迁移后要重新整理，保证 Markdown 里的相对路径仍然有效。
- 先清理无关临时文件。QOwnNotes 的文件树会直接显示文件夹内容，如果目录里有大量 .tmp、.bak 文件，观感会很乱。
- 先备份再改文件名。QOwnNotes 对文件名的依赖程度较高，改名并改内部链接时务必确认双向引用不会断裂。
7. 日常已经离不开的几个小细节
最后再说几个我在实际使用中逐渐发现并养成的习惯，这些细节可能不会出现在官方演示页里，但对提升日常使用效率有很大帮助。
7.1 用"快速插入"功能捕获零散想法
QOwnNotes 的全局快捷键可以在后台呼出一个"快速插入"输入框，不需要打开主界面就能记一条纯文本。这个功能配合 Markdown 语法，让我在开会、看书、临时来灵感的时候，可以不打断当前工作。保存后的内容会落入当前默认笔记，稍后统一整理。长时间使用下来，这个入口比任何"灵感闪念应用"都要顺滑，因为它直接写入同一个 Markdown 数据库。
7.2 定期做"笔记体检"
因为所有文件都是纯文本，我会每隔一段时间跑一次脚本，统计笔记数量和总字数、检查是否有未正确关闭的代码块、有没有异常长的行。QOwnNotes 本身没有提供这种"体检报告"，但脚本引擎可以轻松做到。如果有需要，也可以直接在终端里用 grep 和 wc 简单统计。对比起黑盒数据库格式的笔记，这种透明性带来的安全感是长期使用后最大的收获。
7.3 隐私优先是不是万能答案
说实话，隐私优先并不适合所有人。如果你更看重"关系图谱"和"团队协作"，QOwnNotes 的原始文件模型反而会增加协作成本。但如果你像我一样，笔记是长年累月的资产，需要长期可读、可迁移、可自动化，那么 QOwnNotes 的取舍方向会显得非常合理。它不试图用一堆华而不实的功能来留住你，而是把文件的控制权完全交还给你——这种踏实感，是很多商业笔记工具给不了的。
用了这段时间，我的体会是：工具越简单，长期维护成本越低，数据越安全。QOwnNotes 或许不够惊艳，但它足够可靠，也足够自由。这篇文章写到这，我也又把笔记目录做了一次 git 提交，一切都还在掌控之中。