-
buo4 技术教程组 用户
笔记工具大致分两派：一派以文件为单位，一派以块为单位。
文件派对大多数人来说是熟悉的——一篇笔记就是一个文档，跟用 Word 没本质区别。块派则认为笔记的最小单位不该是文件，而是一个段落、一个列表项、一个标题。因为知识之间的联系，往往精确到某一段话，而不是整篇文档。
思源（SiYuan）属于后者。它的定位是：隐私优先的个人知识管理系统，支持细粒度的块级引用和 Markdown 所见即所得。
块级引用是什么意思
举个具体的例子。
你在三篇不同的笔记里都提到了同一个观点。在文件派工具里，你只能链接到"那篇笔记"，点过去还得自己找是哪一段。在块派工具里，你可以直接引用那一句话，并且反向看到"有哪些地方引用了这段话"。
思源把这件事做到了块粒度，并且配套了几个机制：
- 块级引用和双向链接 ——细粒度到块
- 自定义属性 ——给块加自定义元数据
- SQL 查询嵌入 ——直接在文档里嵌入查询结果，这是块结构带来的额外好处
- siyuan:// 协议 ——可以外部唤起特定块
这个设计不是"功能更多"，而是组织知识的单位变了。一旦粒度变细，很多以前做不到的事就自然成立了——比如"所有引用了这段话的地方"变成可查的，比如用查询动态生成索引页。
功能清单
编辑器
- 块风格编辑
- Markdown 所见即所得
- 列表大纲
- 块聚焦（zoom-in，专注编辑单个块）
- 百万字大文档编辑 ——大文档不卡，这是硬指标
- 数学公式、图表、流程图、甘特图、时序图、五线谱
- 网页剪藏
- PDF 注释链接
导出
- 块引用和嵌入
- 带资源的标准 Markdown
- PDF、Word、HTML
- 一键复制到微信公众号、知乎、语雀
最后这条对国内用户挺实用。写 Markdown 再复制到公众号后台，格式经常乱掉，有专门的处理会省不少事。
其他能力
- 数据库（表格视图）
- 闪卡间隔重复
- 通过 OpenAI API 做 AI 写作和问答
- Tesseract OCR
- 多标签页、拖拽分屏
- 模板片段
- JavaScript / CSS 片段（可自定义外观和行为）
- Android / iOS / 鸿蒙 App
- Docker 部署
- API
- 社区市场
一个值得注意的说明
README 里有一句：
大多数功能是免费的，商用也免费。
这句话单独列出来，说明它的免费范围比一般"个人免费、商用收费"的工具宽。当然也有付费会员专属功能，README 指向了定价页面。
对需要在小团队里使用、又不想踩授权坑的用户，这一点值得留意。
部署方式
覆盖面挺全：
| 方式 | 说明 |
|---|---|
| 应用市场 | 从系统应用商店安装 |
| 安装包 | Windows / macOS / Linux 客户端 |
| 包管理器 | 各类 Linux 发行版的包管理安装 |
| Docker | 自托管服务端 |
| Kubernetes | 集群部署 |
| Unraid | NAS 场景 |
| TrueNAS | NAS 场景 |
Unraid 和 TrueNAS 被单独列出来，说明作者知道自己的用户里有一批是跑 NAS 的。移动端覆盖 Android、iOS、鸿蒙。
谁适合用它
适合：
- 在积累长期、相互关联的个人知识库
- 需要精确到段落的引用和回溯
- 文档很长很大，对编辑器性能敏感
- 有商用需求但不想为授权付费
- 用 NAS 或树莓派做自托管，需要 Docker 部署
- 想把 Markdown 笔记发布到公众号等国内平台
不太适合：
- 只是随手记几条备忘（块结构是额外成本）
- 习惯所见即所得但不想学块概念（思源的界面比 Notion 更密、更技术向）
- 需要多人实时协作编辑同一文档（它更偏个人知识库）
说点实在的
块级笔记工具用起来有个适应期。刚开始你会觉得"为什么引用一个句子还要学新概念"，但知识库积累到几百篇之后，差别就出来了——能定位到块，才能建立真正有用的连接。文件级的双向链接粒度太粗，实际上用不起来。
思源另一个务实的地方是它对"落地"的考虑：Docker 部署、NAS 托管、百万字性能、导出到公众号。这些不是概念，是每天都会碰到的事。README 里连 FAQ（数据怎么存的、丢了仓库密钥怎么办、要不要付费）都列全了，说明作者清楚用户会问什么。
界面比 Notion 密、偏技术向，这是事实。但对打算长期维护知识库的人来说，密度高未必是缺点。