迁出的原因
检索是第一原因。我想找 proxy_read_timeout,在本地 rg 一下就能到文件和行号。在块编辑器里,同一条配置可能被拆进三个块,搜索结果还夹着会议纪要。
第二是导出。笔记一旦和专有格式绑在一起,换工具就要重新排版。Markdown 加上固定的一级标题,迁到这个静态站几乎是复制。
第三是离线。火车上改 unit 文件备注,不必等同步转圈。
现在的目录
notes/
ops/nginx.md
ops/systemd.md
lang/python-typing.md
books/ddia.md
inbox.md
新东西先丢进 inbox.md,每周五挪到对应文件。不为每条笔记建新文件,避免目录比内容还长。
文件头只写日期和标签两行。不写情绪化的标题。命令用代码块,解释写在命令上面,方便以后只扫代码块。
同步怎么做
仓库私有,本机和家里电脑用 git。手机只读,用一个能看 Markdown 的应用打开 clone。不追求多端同时编辑,避免冲突。
图片单独放 notes/assets/,文件名用日期加简述。不把截图直接粘进数据库式的附件里。
这套方法不适合需要多人评论的文档。那种仍用团队的 wiki。我自己的备忘,纯文本就够。