本地优先 Markdown 笔记：拥有文件，而不是订阅

本地优先 Markdown 笔记，指的是你的笔记以普通 .md 文件的形式存在自己的磁盘上，而不是在某家公司的数据库里。你像对待任何文件一样打开、编辑、备份它们。没有账号、没有同步服务器、也没有横在你和文字之间的月费。对于本就生活在编辑器和终端里的开发者来说，这是最持久的记笔记方式。本文说明为什么我们认为，在绝大多数个人场景里它胜过云端笔记应用。

我们自己做本地优先编辑器，立场并不中立。但本文谈的是格式和文件放在哪里，而不是某个具体应用。如果你读完只在一个 markdown 文件夹上加了 git，那也是成功。

本地优先到底是什么？

本地优先是一个简单的性质：数据的真相来源是你机器上的文件，应用只是它之上的一层镜片。同步（如果有）是你可控的可选项，而不是打开自己笔记的前提。云优先工具正好相反：数据库才是真相，文件导出只是有损的附属品。

检验很简单。卸载应用，你还能用纯文本编辑器读到每一条笔记吗？本地优先 Markdown 可以；大多数云端应用只会丢给你一个 HTML 压缩包，或一份丢掉一半结构的私有格式导出。

为什么把笔记放在本地优先？

对一线开发者来说，四个理由占了绝大部分分量：

• —隐私：除非你主动发出去，文件不会离开磁盘。默认没有任何上传、索引或数据挖掘。写了一半的想法仍然只属于你。
• —长久：纯 Markdown 20 年后依然可读。没有要破解的私有格式，也不依赖某家公司必须继续存在。
• —可 git 版本管理：笔记文件夹就是源代码，完整历史、diff、分支、blame 全部免费。
• —无锁定无订阅：一次买断或免费编辑器，改主意那天就能原样迁移到任何其他 markdown 工具。

20 年后依然可读的纯文本

Markdown 是记笔记里最接近归档格式的东西。它人类可读，哪怕没有任何工具，用记事本打开 .md 也能看懂；它是事实标准，已有数百个编辑器能解析；它可 diff，版本管理把它当作一等文本而非不透明的数据块。

对比一下被困在云端块编辑器里的笔记：一旦厂商改结构、下线产品或被收购，你的归档就把命运交给了一个需要有人持续维护的导出按钮。纯文件没有这种依赖，文件本身就是归档。

用 git 给 Markdown 笔记做版本管理

这是云端应用无法比拟的部分，而且一分钟就能配好。在笔记文件夹里打开终端，运行 git init，然后 git add . 和 git commit -m "notes"。就这样。此后每次修改都能提交，你就有了一份完整、带时间戳的思考历史。

接下来常用的 git 工具都能用在笔记上：git diff 看今天改了什么，git log 回溯过去版本，git checkout 找回上周删掉的段落。把同一个文件夹 push 到私有远程，就有了异地备份和跨设备同步，全程不经过任何笔记应用的云。

云端笔记应用真正胜出的地方

本地优先并非没有取舍，假装没有就不诚实了。如果多人要同时编辑同一份文档，像 印象笔记 或飞书文档这样的云端协作工具就是更好。实时协同、评论线程、可分享链接和关系型数据库，都是文件夹不擅长的。这方面我们在 Tybre 与 Notion 对比里有详细展开。

所以诚实的判断是：协作和结构化数据库是核心时选云优先；笔记基本是自己的、你在意隐私、长久与掌控时选本地优先。多数开发者的个人笔记、调研和日志都落在后者。

为你的 Markdown 文件夹准备的本地优先编辑器

只用文本编辑器加 git 完全能跑本地优先笔记。但一个所见即所得编辑器能让日常写作舒服得多，同时保持文件为纯文本。Tybre.md 正好补这个位：一个约 5MB 的原生应用，打开 .md 文件夹，用 syntax-reveal 渲染，并且从不要求云端账号。文件留在磁盘上，正好是 git 能看见的地方。

它还补上把文件夹变成真正知识库的连接组织：一个揭示笔记间反向链接的 wikilink 关系图视图，以及一个能在文字旁边直接提交的内置终端。如果你在和另一款流行的本地 markdown 工具之间权衡，我们的 Tybre 与 Obsidian 对比按功能逐项做了公正比较。

云端笔记 vs 本地优先 Markdown 一览