📝 思源笔记SiYuan：45K Star本地优先块级双链笔记 Markdown数据库插件

思源笔记 SiYuan 是一款 AGPL-3.0 开源的本地优先块级双链笔记软件，45.1k Star、24,098 次提交。支持 Markdown 即时渲染、数据库、插件系统、多端同步（PC/Mac/Android/iOS）和 Docker 自部署，是 Notion 之外的开源本地化最强选项。

🎤 引言

记笔记这件事，工具党和技术党永远吵不完。

Notion 功能齐全但锁死在云端（国内访问慢 + 数据不在本地），Obsidian 本地化优秀但没有原生数据库和插件生态封闭（要会写 JS），语雀/飞书协作强但对个人用户做知识库显得"过重"。

思源笔记（SiYuan）这个国产开源项目走了第三条路：本地优先 + 块级双链 + Markdown 即时渲染 + 真正的数据库视图 + 开放的插件生态 + Docker 自部署可选。

GitHub 上 siyuan-note/siyuan 仓库截至 2026-07-12 有 45.1k Star、2.9k Fork、24,098 次提交、918 个发布版本，是国产开源笔记软件里绝对的顶流项目。背后由 D 语言创始人之一「88250」个人主导维护，AGPL-3.0 开源协议，多端覆盖（PC/Mac/Linux/Android/iOS）。

⭐ 核心功能

1. 块（Block）+ 双链（Bi-directional Link）：思源的核心抽象

传统笔记按"文档"组织，思源是按"块"组织的。一段文字、一张图片、一段代码、一个公式都是一个独立的块，块可以任意嵌套组合成"超级块"。

块的引用通过 ((块ID)) 或 【链接】 语法建立，自动形成双向链接（A 引用 B 后，B 的反向链接面板会自动显示 A）。这跟 Obsidian 的 [[wikilink]] 思路一致，但思源的"块"粒度更细 —— 你可以双链一段文字、一个代码块、一个引用，这是文档级双链工具做不到的。

实际体验上：鼠标悬停引用文本 → 弹出浮层预览内容 → 不需要跳转。浏览一篇长文，所有引用随手可查，这是块级双链的核心价值。

2. Markdown 即时渲染，所见即所得

跟传统 Markdown 编辑器需要"切换源码/预览"不同，思源是真正的所见即所得 —— 你打字时屏幕就是最终渲染效果。

但同时底层还是 Markdown 文本结构（不是某些"伪 Markdown"），导出兼容性 100%。中文输入有专门优化 —— 斜杠 / 和顿号 、 都可以调出菜单，不需要切换输入法。这个细节对中文用户真的友好。

3. 数据库视图：Project 管理 / 收支 / 客户关系都能做

思源内置了原生数据库视图，功能接近 Notion 的 database：

• 可定制字段：文本、数字、日期、选择、链接、子文档、关联到另一个数据库
• 查询 / 排序 / 筛选：快速从数据集中提取
• 多格式支持：图像、链接、嵌入块都可以作为字段值
• 未来支持看板视图：官方路线图已经规划

很多人拿它做项目管理（一个数据库管 sprint）、客户关系（一个数据库管客户和合同）、阅读清单、个人 OKR。可玩性很高。

4. 多端同步：官方云 / 第三方 S3 / 自部署

思源提供三种同步方案适配不同预算：

Docker 自部署可以一键启动后端，整个数据完全在自己服务器上，对隐私敏感用户极度友好。

5. 插件 / 挂件 / 集市：生态活跃

思源有官方集市，几百个免费插件和挂件（挂件相当于小组件，比如天气、番茄钟、计算器）。覆盖场景包括但不限于：

• 发布工具：把笔记发布到博客（tycp.xyz 这种 Typecho 也支持）
• AI 助手：接入 OpenAI、通义千问、DeepSeek 等做摘要/翻译/对话
• Web Clipper：官方浏览器剪藏插件
• 思维导图 / 看板 / 习惯打卡 / 番茄钟等小工具

插件市场对开发者开放，自己写 JS 插件和挂件也支持。

6. 高度自定义：主题 / CSS / 布局

内置 Asri、写味等高颜值主题，还支持自定义 CSS 修改任意样式（透明度、字体、间距），社区有大量主题分享。布局上支持多窗口分屏，左右拖拽对比笔记、双屏记录等场景非常方便。

📥 安装使用

安装

思源笔记提供完整的多端安装包：

# Windows / macOS：直接下载安装包
# GitHub Releases: https://github.com/siyuan-note/siyuan/releases

# Linux（Debian/Ubuntu）：
sudo dpkg -i siyuan_xxx.deb

# Docker 自部署后端：
docker run -d \
  --name siyuan \
  -p 6806:6806 \
  -v /opt/siyuan-data:/workspace \
  b3log/siyuan \
  --workspace=/workspace

第一次使用

1. 启动 → 选择工作空间（建议放在云盘同步目录或自有 NAS）
2. 新建文档 → 在右侧输入 / 调出菜单 → 选样式（标题/列表/代码块/引用...）
3. 选中文字 → 右侧菜单 → 创建链接 → 自动生成块引用
4. 鼠标悬停引用 → 看预览浮层

进阶：自部署 + Web 客户端

完全私有化部署参考 Docker 命令：

# docker-compose.yml
version: '3.8'
services:
  siyuan-kernel:
    image: b3log/siyuan
    container_name: siyuan-kernel
    restart: unless-stopped
    command: --workspace=/siyuan/workspace
    ports:
      - "6806:6806"
    volumes:
      - ./workspace:/siyuan/workspace
      - ./ssl:/siyuan/ssl

启动后访问 http://localhost:6806 进入 Web 客户端，所有数据保存在 ./workspace。

进阶：S3 同步配置

在不订阅官方云的情况下，可以用阿里云 OSS / 腾讯云 COS / AWS S3 等第三方云存储做同步：

1. 在思源设置 → 云端 → 选择"S3"
2. 填入云服务商的 endpoint、bucket、AccessKey
3. 触发一次同步 → 之后所有客户端自动同步

一次配置长期使用，64 元买断功能费 + 极低的存储费，比年费订阅划算得多。

进阶：插件安装

思源设置 → 集市 → 浏览插件 → 一键安装。也可以从 GitHub 社区下载 .zip 插件手动安装。

🎯 适用场景

1. 个人知识管理（PKM）重度用户

如果你已经在用 Notion / Obsidian / Logseq，但觉得差点什么：

• Notion 太依赖云端 + 国内访问慢 → 思源本地优先
• Obsidian 没有原生数据库 → 思源有原生数据库视图
• Logseq 块级但界面偏极客 → 思源更"开箱即用"

2. 写作 + 长期内容沉淀

博主、自媒体作者、研究者 —— 用思源写文章、做主题研究、做素材归档。双链让"想到 A 就拉出 B、C 相关内容"，长年累月形成的笔记网络价值是线性笔记做不到的。

3. 项目管理 / 团队轻协作

数据库视图 + 模板 + 多端同步，对小团队项目管理足够用（不如专业 PM 工具但个人和 3-5 人小团队完全够）。

4. 隐私敏感 / 数据自托管用户

服务器自部署 + 数据本地化，对隐私敏感的律师、医生、研究者很合适。

🔍 对比/替代方案

思源的定位：本地的 Notion + 开源的 Obsidian + 原生 Markdown。 它不是 Notion 的完美替代（协作能力差），也不是 Obsidian 的复刻（多了数据库和中文优化）。对于"个人 PKM + 本地优先 + 不要云绑架"的用户，思源是 2026 年最值得关注的选择。

⚠️ 注意事项

1. 同步功能收费（但买断制）

思源本身完全免费，但官方云同步（148 元/年）和 S3 同步集成（64 元买断）是收费扩展功能。日常单机使用 0 元，需要多端同步才需要付费。

2. 学习曲线存在

块级双链、数据库、SQL 查询（思源支持 SQL 查询块）这些概念对新手不是零门槛。建议：

• 先用一周建立笔记 → 再用双链
• 数据库从 2-3 个字段的简单表开始
• 插件按需安装，不要一次性堆 30 个

3. 移动端体验略弱于桌面

Android 和 iOS 客户端功能完整，但移动端编辑长文不如桌面流畅（受屏幕限制）。同步和阅读体验没问题，重度写作建议桌面端。

4. 第三方插件质量参差

集市上几百个插件质量不一，部分插件长期不更新可能失效。建议：

• 看插件的最近更新时间
• 看 Issue 区有没有未解决的崩溃报告
• 关键功能优先用官方

5. AGPL-3.0 协议合规

AGPL-3.0 比 MIT/Apache 严格 —— 衍生作品必须开源。个人使用没问题，但如果基于思源二次开发商业产品分发，需要遵守协议。

✅ 总结

思源笔记优点：

• ✅ 45.1k Star、24,098 次提交，国产开源 PKM 顶流
• ✅ 块级双链：比文档级双链更细，引用更灵活
• ✅ Markdown 即时渲染 + 中文输入优化
• ✅ 原生数据库视图：可玩性极高
• ✅ 多端覆盖：PC/Mac/Linux/Android/iOS 全平台
• ✅ 同步灵活：免费单机 / 官方云 / S3 / 自部署任选
• ✅ 插件生态活跃：集市 + CSS 自定义
• ✅ AGPL-3.0 开源，数据安全可控

已知短板：

• ⚠️ 学习曲线存在，新手需要 1-2 周磨合
• ⚠️ 官方云同步 + S3 集成是付费扩展（但买断制不贵）
• ⚠️ 移动端重度写作体验不如桌面
• ⚠️ 第三方插件质量参差，需甄别
• ⚠️ AGPL-3.0 协议比一般宽松协议严格

适合人群：

• 个人知识管理（PKM）重度用户，想要本地优先 + 块级双链 + 数据库的全能工具
• Notion 受限（国内访问）或 Obsidian 受限（无原生数据库）的转型用户
• 数据隐私敏感的研究者 / 律师 / 医生
• 长期写博客 / 写书 / 做研究的创作者

不太适合：

• 需要团队协作 5+ 人同时编辑的团队（飞书/Notion 更合适）
• 只想 5 分钟上手、不愿学习的用户
• 主要用手机记笔记、对移动体验要求极高的用户（Obsidian/Logseq 移动端更流畅）

个人推荐：如果你是技术背景 + 隐私偏好 + 重度笔记用户，思源笔记几乎就是 2026 年你能找到的最优解。先用一周建立几十篇笔记 + 几个数据库，感受一下"块级双链 + 数据库"的化学反应，再决定要不要付费同步。

📦 GitHub 仓库：https://github.com/siyuan-note/siyuan

🌐 官方网站：https://b3log.org/siyuan

📚 官方文档：https://docs.siyuan.note

🎬 社区插件 / 主题集市：思源笔记设置 → 集市