📌 项目：https://github.com/siyuan-note/siyuan | 星数：46940 | 语言：TypeScript | 协议：AGPL-3.0 | 更新：2026-10-26
思源笔记是siyuan-note团队开源的自托管知识工作空间，46.9k颗星，TypeScript编写。定位是"隐私优先的个人知识管理"——块级引用（比文档级双链更精细）+Markdown所见即所得+SQL查询+本地优先+AI协作。知识管理工具分两派：Notion（云端/数据库/协作，但数据在Notion）和Obsidian（本地/双链/插件，但非所见即所得）。思源笔记取两者之长——本地优先数据自控（像Obsidian）、所见即所得编辑（像Notion）、块级引用比双链更精细（每个段落/列表项/表格行都可引用）、SQL查询结构化检索、AI助手辅助写作。4.7万星说明中文知识管理社区对"本地+精细引用"的强需求。
相关工具与方向，可参考Dify Rag Knowledge Base Tutorial；Anythingllm Knowledge Base Setup；Langchain Rag Knowledge Base Tutorial。
块级引用与双链：思源笔记的核心是块级引用——不只是文档之间链接，而是文档内的每个块（段落/标题/列表项/表格行/代码块）都有唯一ID可被引用。[[文档名]]链接到文档，((block-id))引用到具体块，引用可嵌入显示（块引用/嵌入块）。这比Obsidian的文档级双链更精细——你能引用"某文档第三段那个论点"而非整篇。反链面板显示所有引用此块的地方，形成知识网络。块可挂标签/自定义属性，SQL查询按属性检索。这适合做研究笔记/法律条文引用/学术文献管理。
所见即所得与多端：思源笔记用Markdown所见即所得——输入# 变标题、- 变列表、```变代码块，实时渲染不分裂编辑/预览（不像Obsidian分编辑和预览模式）。支持表格/数学公式/Mermaid图/思维导图/流程图。多端：桌面App（Mac/Win/Linux）、移动App（iOS/Android）、Docker自托管Web版。同步方案灵活——官方同步付费（便宜），或WebDAV/S3/自托管服务器免费同步。数据用JSON+文件存储，可导出Markdown。本地优先，断网可用。
AI助手与生态：思源笔记内置AI助手——选中文本让AI续写/总结/翻译/改写，或对话式提问（基于笔记内容）。支持配置OpenAI/本地Ollama。插件系统（市场有数百插件）扩展功能（日历/看板/模板/导出）。模板系统支持变量/动态填充。闪卡（间隔重复记忆）做学习笔记。S3/WebDAV备份。开源免费（AGPL-3.0），付费版加同步/资源图床。与Obsidian的差异：思源块级引用更精细+所见即所得，Obsidian插件生态更丰富+Markdown纯文本。
| ✅ 优势 | ❌ 劣势 |
|---|---|
| 块级引用比双链更精细 | 学习曲线（块概念） |
| Markdown所见即所得 | 插件生态不如Obsidian |
| SQL查询结构化检索 | 同步方案需配置 |
| 本地优先多端+自托管 | JSON格式不如纯MD通用 |
| 内置AI助手可配本地 | 社区规模较小 |
引用粒度思源更细——块级（段落/列表项）vs Obsidian文档级双链。编辑思源所见即所得（实时渲染），Obsidian分编辑/预览模式（虽有Live Preview）。数据思源用JSON+文件，Obsidian纯Markdown（更通用）。生态Obsidian插件远多于思源。同步思源官方付费便宜或自托管免费，Obsidian靠第三方插件。建议：要块级精细引用+所见即所得→思源；要纯Markdown+海量插件→Obsidian。
数据存本地data文件夹，笔记用JSON格式（含块ID/属性/内容），素材/附件单独文件。可导出为Markdown（每篇一个.md），但块级引用/SQL属性等结构化信息导出为MD会丢失部分。导入支持Markdown/HTML。JSON格式不像纯MD通用，但思源开源（AGPL）+导出Markdown降低锁定风险。建议关键笔记定期导出MD备份。迁移到Obsidian走MD导出，但块引用变普通链接。
同步三种方式：官方同步（付费，便宜，端到端加密）、WebDAV/S3（免费，自己配）、自托管Docker服务器（免费，多端访问）。AI助手：选中文本右键让AI续写/总结/翻译/改写，或对话框提问。支持配OpenAI（GPT-4）或本地Ollama（免费隐私）。AI可基于当前笔记内容回答（需配置）。AI是辅助不是替代——帮你写/改/问，知识结构仍由你构建。建议本地Ollama获得隐私+免费的AI辅助。