企业官网建设流程全解析

思源笔记快速入门：5 步把碎片笔记变成带双向链接的本地知识库

【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间，让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan

笔记散落在各个 App 和文件里，写完就再也没找过？思源笔记是一款开源、隐私优先、本地存储的笔记工具，它把内容拆成可寻址的"内容块"，再用双向链接把它们连起来，数据完全留在你自己的设备上。这篇文章讲清楚块这个核心概念、跑通从安装到第一条链接的最短路径，再给出 3 个可以直接照做的用法，读完后你手里会有一个能自己长起来的知识库。

先搞懂内容块：思源笔记最核心的概念

每一段内容都是可独立寻址的块 🧱

在思源笔记里，组织知识的最小单位不是文档，而是"块"——段落、标题、列表项、表格，都是块。类比一下：它像图书馆的卡片目录，每张卡片（块）有唯一 ID，可以被别的笔记直接引用，也可以整体拖走复用，原文不用复制粘贴。操作很直接：鼠标悬停到段落上，左侧出现"⋮⋮"手柄，按住就能拖；右键块弹出菜单，移动、复制、引用都在里面。

双向链接自动织成知识图谱 🔗

你在 A 笔记引用了 B 笔记的某个块，B 笔记的"反向链接"面板会立刻列出 A 的位置，关系是双向自动维护的，不需要手动记账。右侧栏再打开"图谱视图"，所有块之间的关系以节点和连线展示，哪些概念只出现过一次、哪些是枢纽，一眼可见。

数据就是一个纯文本文件夹，你可以亲眼验证

每篇文档对应一个.sy文件，本质是 JSON，存放在工作区的data目录下，任何文本编辑器都能打开读。备份就是把整个工作区文件夹拷走，这是"本地优先"真正的兜底。

快速上手：从安装到第一条链接的 5 步

1. 下载安装：从官网或应用商店（Windows / macOS / Linux / 移动端）下载对应安装包，启动后创建一个工作区，它是所有数据的根目录。
2. 建笔记本和文档：点左上角"+"新建笔记本，右键笔记本选"新建文档"，先命名一篇"读书笔记"。
3. 开始写作：回车生成段落块，输入##变标题，输入/唤起功能菜单，列表、代码、表格等块类型都能直接插入。
4. 建立引用：在编辑区输入[[，搜索框会匹配整个工作区的块和文档，回车即插入一条块引用，鼠标悬停在引用上会弹出内容预览。
5. 验证结果：右侧"反向链接"面板已显示谁引用了当前块，打开"图谱视图"能看到第一张小网络。

[

真实使用场景：从书单数据库到间隔复习

把阅读笔记做成可查询的书单数据库 📚

问题：读了十几本书，想回答"我读过什么、作者是谁、哪本和哪本相关"，单篇文档越来越难维护。操作：新建一个"Books"数据库，设置作者、作品、数量等字段，每本书的笔记单独建文档并填写字段，数据库自动聚合，表格、卡片、画廊三种视图随时切换。效果：卡片视图把封面拼成书架画廊，"数量"字段自动统计每位作者的作品数，整本书架变成一个可筛选、可排序的数据库。

把碎片知识做成间隔复习的闪卡

问题：读完想记住，但靠意志力重读笔记基本不可能。操作：任意段落或列表项都能变成闪卡，进入专注模式后按"Again / Good / Easy"按钮自评。效果：间隔算法自动安排下次出现时间，错的卡出现得更勤，每天刷 20 张也就十分钟。

把 PDF 和长文变成可引用的块

问题：想摘录 PDF 里的关键段落，复制文本会丢失出处。操作：把 PDF 拖进笔记，批注直接关联到 PDF 对应位置，再用块引用把段落摘到"摘录"笔记里。效果：摘录笔记成为一层积累，原文位置永不丢失，随时回溯。

常见坑位与进阶技巧

误解：把数据目录放进云盘就能跨设备同步

⚠️ 千万别这么干。官方 FAQ 明确写了：不支持用第三方同步盘同步工作区，否则数据可能损坏。正确做法二选一：用官方云同步，或者在"设置 → 导出"里手动导出/导入数据。只要备份需求，直接拷贝整个工作区文件夹。

高频疑问：删错了能找回吗

能。数据历史每 10 分钟生成一次快照（间隔可在"设置 → 编辑器"调整），删除文档、清理解释资产后都能进历史页回滚。

高频疑问：列表项里的块为什么没有左侧手柄

这是刻意省略，不是故障。把光标放进该块，按Ctrl+/即可唤起块菜单完成移动、引用等操作。

进阶：用 SQL 直接查询笔记数据

更复杂的需求，比如"把打了 #待讨论 标签的块全部拉出来"，可以在查询块里写 SQL，或在命令行跑内置 CLI：

siyuan notebook list -w ~/SiYuan siyuan search "关键词" -w ~/SiYuan -f json

资源与延伸

• 内置使用指南：仓库 app/guide/ 目录即完整的"思源笔记使用指南"笔记本，应用首次启动也会打开
• 格式与接口文档：docs/API.md（内核 API）、docs/SY-FORMAT.md（.sy 文件结构）、docs/WORKSPACE.md（工作区磁盘布局）
• 版本变更记录：CHANGELOG.md 与 app/changelogs/
• 想读源码可以直接git clone https://gitcode.com/GitHub_Trending/si/siyuan
• 同类开源笔记：Logseq（大纲流）、Joplin（端到端加密同步），侧重不同，可以装来对比后再定

把块拖一拖、建一个数据库，日常用法就有八成。挑一篇你现有的笔记搬进新工作区，边用边改。

【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间，让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan