把笔记当成代码来管理：纯文本加 Git 的个人知识库

攒过笔记的人多半有这种经历：笔记软件换了一个又一个，笔记越记越多，真要找的时候却翻不出来；换机、重装之后，一堆笔记不知道怎么迁移；更别扭的是，很多笔记锁在某个专用软件里，格式是私有格式，哪天软件不维护了，笔记就成了打不开的古董。有没有一种办法，让笔记像代码一样，永远属于自己、随时能版本管理？答案是有的，思路其实很朴素：用纯文本写笔记，用 Git 管起来。这套做法在技术圈流行已久，但对普通写作者来说依然相对陌生，值得认真地介绍一番。

为什么是纯文本

纯文本最大的好处，是它不挑工具、不怕时间。一段用简单标记写的文字，十年后任何编辑器都能打开，不会因为某个软件停止更新而报废。相比之下，那种只能在自家 App 里看的笔记，本质上是把数据寄存在别人的围墙里。

而且纯文本足够轻。你可以用任何顺手的编辑器写，配合一点简单的标记语法——标题用井号、列表用短横、加粗用星号——就能让笔记既有结构，又依然是普通文本。这种写法学习成本极低，写久了几乎感觉不到它的存在，换个编辑器也不用重新适应，更不用担心被某种私有格式锁死。

Git 能为笔记做什么

把笔记放进 Git 仓库，第一个直接的好处是版本历史。你改了什么、删了什么，每一次提交都留着记录。哪天发现某段话删错了，随时可以翻回去看旧版本，甚至能对比出两个时间点之间到底差在哪。这对经常大段修改笔记的人来说，等于多了一层后悔药。

第二个直接的好处是同步和备份。本地一个仓库，再推送到远端，笔记就有了第二份、第三份副本。换了电脑，克隆下来接着写；不小心误删，远端还在。Git 天然就是一套分布式的版本控制系统，用它管笔记，等于白捡了一套完整的备份与历史机制。

第三个好处是结构化。一个文件夹就是一个主题，一个文件就是一篇笔记，层级自己定。比起软件里那种靠标签和笔记本堆叠的组织方式，文件系统本身就是最直观的目录，找东西时顺着文件夹翻就行，一目了然。想给某类笔记单独开个目录，新建文件夹就好，不用在软件里研究怎么分组。

实际怎么开始

起步其实很简单。新建一个文件夹当作你的笔记库，把里面每篇笔记写成一个文本文件，文件名直接用笔记的标题，好找又好认。然后在这个文件夹里初始化一个 Git 仓库，每次写完笔记就提交一次，写清楚这次改了什么。习惯了之后，这几乎是下意识的动作。

想多设备同步，就把这个仓库推到一个代码托管平台上，出门用另一台电脑时克隆下来接着写。手机上也有能操作 Git 的编辑器，配合一下就能随时随地记两笔。整个过程不依赖任何专门的笔记服务，数据完完全全在自己手里。

笔记之间怎么串起来

单独一篇笔记只是信息，真正有价值的是笔记之间的联系。纯文本里做这件事很简单：用双方括号或者普通的相对链接，就能从一篇笔记跳到另一篇。今天读到一个概念，写篇笔记记下来；过几天想到它和另一件事有关，就在两边互相加个链接。时间一长，你的笔记库会自己长成一张网。

这种”双向链接”的思路，最近几年特别受欢迎，很多新出的笔记工具都在做这件事。但它的本质并不神秘，就是在纯文本之间互相指来指去。你甚至不需要花哨的软件，只要坚持把相关的笔记连起来，知识自然会在你脑子里长成型。工具只是帮你把这个过程外化、留下痕迹。

为什么很多人绕了一圈又回来

回顾自己折腾笔记工具的经历，很多人都会发现一个规律：一开始追新，哪个软件火就试哪个，功能越多越开心；用久了才发现，真正缺的从来不是功能，而是稳定、自由和不被绑架。软件会改版、会涨价、会关停，只有自己掌控的数据才能陪你走很久。

纯文本加 Git 这套组合，看起来”复古”，却恰恰踩中了长期主义。它不追新花活，只做几件最基本的事：能写、能存、能追溯、能带走。当你不再需要为软件的变化而迁移笔记时，省下来的精力，才能真正用在记录和思考本身。这大概就是最简单方案最耐久的原因，也是很多技术人最后都不约而同回到这里的原因——工具会过时，但自己写下的文字和它的历史，会一直都在。

一点提醒

这种方式不是没有门槛。你得接受命令行、接受一点点 Git 的基本概念，不像开箱即用的笔记软件那么”傻瓜”，刚开始可能要花一两个晚上熟悉基本操作。但换来的是长期的自由：笔记格式永远开放，不被任何一家产品绑架，就算十年后换了新工具，数据照样能无缝接过去。

另外，别一开始就追求完美的目录结构和万能模板。先写起来，笔记库是慢慢长出来的，不是一开始就设计好的。工具的意义是帮你记录和思考，而不是花一整天折腾格式。把笔记真正写下来、定期回顾，比用什么工具都重要。纯文本加 Git，只是让这件事更长久、更安心而已。

还有一个现实好处：因为是纯文本，笔记非常适合做全文搜索。想找一句话里提到的某个词，在整个文件夹里一搜就出来，比在软件里翻标签快得多。配上版本历史、全文检索和互相链接，一个本地文件夹就能变成相当能打的个人知识库，而不需要依赖任何在线服务。数据在自己硬盘上，离线也能用，不联网也能随时查阅和修改，这份踏实感，是很多花哨软件给不了的。