了解 Siyuan Notes 的方方面面
如果你正在寻找一款强大、灵活且数据完全掌控在自己手中的笔记或知识管理工具，你可能已经听说过 Siyuan Notes。本文旨在围绕【siyuan笔记】这一核心，直接解答大家普遍关心的问题，从它是什么到如何深入使用，提供详细具体的介绍。
是什么：Siyuan Notes 究竟是什么？
简单来说，Siyuan Notes (思源笔记) 是一款
本地优先 (Local-First) 的、
块 (Block) 结构的、
支持双向链接 (Bidirectional Links) 的个人知识管理系统和笔记工具。
- 本地优先： 这意味着你的所有数据都默认存储在你自己的电脑或设备上，而不是托管在第三方服务器。你完全拥有和控制你的数据。
- 块结构： Siyuan Notes 不仅仅是将文本存储为一整页。页面内容被分解成更小的单元，称为“块”。一个段落、一个标题、一个列表项、一张图片、一个代码块，甚至一个嵌入的内容，都可以是一个独立的块。这种结构提供了极高的灵活性，你可以引用、嵌入、查询和操作单个块。
- 双向链接： 这是构建知识网络的核心功能。你可以轻松地在一个笔记中链接到另一个笔记的特定页面或特定块。更重要的是，Siyuan Notes 会自动记录哪些地方链接到了当前页面或块（即“反链”或“回链”）。这让你能够轻松地在你的知识库中穿梭，发现关联。
- 所见即所得 (WYSIWYG) 编辑器： 虽然底层支持 Markdown，但 Siyuan Notes 提供一个直观的所见即所得编辑体验，让编辑过程更加顺畅，无需时刻关注 Markdown 语法。同时，你也随时可以查看或编辑 Markdown 源码。
- 知识图谱： 通过双向链接，Siyuan Notes 可以将你的笔记构建成一个可视化的知识网络图谱，帮助你直观地看到不同笔记之间的关系和连接密度。
不同于传统线性或层级结构的笔记软件，Siyuan Notes 鼓励你以更网状、更灵活的方式组织和连接你的想法。
为什么：为什么要选择使用 Siyuan Notes？
选择 Siyuan Notes 而非其他笔记工具的原因有很多，主要体现在其独特的设计理念和功能上：
- 数据主权与隐私： 这是许多用户选择 Siyuan 的首要原因。数据完全存储在本地，不依赖云服务，你的数据安全和隐私完全由你自己掌握。
-
极致的灵活性与组织方式：
- 块级操作： 可以像乐高积木一样组合、重用、嵌入和引用信息块，极大地提高了笔记内容的复用性和组织灵活性。
- 非线性的链接： 双向链接打破了传统的层级限制，让你可以根据内容的相关性自由地建立连接，构建符合你思维模式的知识网络。
- 多种组织维度： 除了传统的文档树结构，你还可以使用标签、属性、引用、查询等多种方式来组织和查找信息。
- 强大的连接与发现能力： 双向链接和知识图谱不仅帮助你建立联系，更重要的是帮助你发现隐藏的关联和之前未曾意识到的知识路径。
- 性能： 由于数据在本地，通常拥有非常流畅的编辑和加载速度，即使是包含大量笔记的知识库。
- 可扩展性： 支持主题定制（CSS）、功能增强（JavaScript Snippets），甚至提供了 API，允许用户进行深度定制或开发插件。
- 离线可用： 由于是本地应用，即使没有网络连接，你也可以随时访问和编辑你的所有笔记。
如果你注重数据安全、喜欢精细化地管理和连接信息、希望构建一个属于自己的、高度互联的知识库，并偏好本地应用带来的性能和控制力，那么 Siyuan Notes 可能非常适合你。
哪里：在哪里获取 Siyuan Notes？数据存储在哪里？
-
获取途径：
- 官方网站： 你可以访问 Siyuan Notes 的官方网站 (通常是 siyuan.b3log.org) 下载最新版本的桌面客户端（支持 Windows, macOS, Linux）。
- GitHub Releases： 作为一款开源项目（部分核心代码），你也可以在项目的 GitHub 页面找到各个版本的发布文件进行下载。
- 包管理器： 在某些 Linux 发行版上，Siyuan Notes 也可能通过 Snapcraft 等包管理器提供。
-
支持平台：
- 桌面端： 提供成熟稳定的 Windows、macOS、Linux 客户端。
- Web 端： Siyuan Notes 可以启动一个本地服务器，让你通过浏览器访问和使用笔记，这也可以用于局域网内的访问或作为移动端访问的基础。
- 移动端： 提供了 iOS 和 Android 客户端。移动端的功能可能与桌面端略有差异，主要侧重于浏览、记录和轻度编辑。通过 Web 端访问也是一种常用的移动使用方式。
-
数据存储位置：
你的所有笔记数据都存储在你本地文件系统的一个指定文件夹中。
当你首次启动 Siyuan Notes 时，它会要求你选择或创建一个新的工作空间（Workspace）。这个工作空间文件夹就是你的笔记数据所在地。Siyuan Notes 会在这个文件夹内部创建特定的子文件夹和文件来存储你的文档、图片、附件、配置等所有数据。
这意味着你可以随时备份、移动或复制整个工作空间文件夹，以管理你的数据。数据文件通常是基于 Markdown 和 JSON 格式，这在理论上也提高了数据的可读性和可移植性（尽管直接编辑这些文件不被推荐）。
多少：使用 Siyuan Notes 需要花钱吗？有哪些版本？
-
免费版本： Siyuan Notes 提供功能强大的免费版本。免费版本包含了本地使用所需的大部分核心功能，包括：
- 创建和编辑无限数量的笔记和工作空间
- 块结构编辑
- 双向链接和反链
- 知识图谱
- 块嵌入和引用
- 基础的组织和查询功能
- 本地数据存储
- 基础主题和外观设置
对于只需要在本地管理个人知识，不依赖官方同步服务的用户来说，免费版本已经非常够用。
-
专业版本 (Pro)： 专业版本通过订阅解锁更多高级功能和便利性：
- 官方同步服务： 提供安全、可靠、跨设备的官方云同步服务，解决多设备同步的痛点（免费版需要自己搭建或使用第三方同步方案）。
- 更多高级功能： 例如，更强大的查询能力、更多的数据分析功能、集成更多的第三方服务等（具体 Pro 功能会随版本更新有所变化）。
- 更多社区资源访问： 获得更多由社区贡献的主题、插件等资源的使用权限。
- 支持项目发展： 订阅费用也用于支持 Siyuan Notes 项目的持续开发和维护。
你可以根据自己的需求选择免费版本或订阅专业版本。通常建议先尝试免费版本，如果需要官方同步或更高级功能，再考虑升级到 Pro。
如何使用：Siyuan Notes 的基本操作与进阶技巧
学习使用 Siyuan Notes 主要在于理解其“块”和“链接”的核心概念，并掌握相关的操作。
安装与首次启动
- 从官方网站或 GitHub 下载对应你操作系统的安装包。
- 运行安装程序并按照提示完成安装。
- 首次启动时，选择一个文件夹作为你的工作空间目录（或创建一个新的）。这是你的所有笔记数据存放的地方。
- 进入主界面，你就可以开始创建笔记了。
基础笔记创建与编辑
- 新建文档： 在左侧的文档树视图中，选择一个笔记本，右键点击或使用菜单项选择“新建文档”。输入文档标题。
- 输入内容： 在编辑器区域直接输入文字。每按一次回车键，通常就会创建一个新的段落块。
-
创建不同类型的块：
- 输入 `# ` 后跟文字可以创建标题（# H1, ## H2, ### H3 等）。
- 输入 `- ` 或 `* ` 后跟文字可以创建无序列表。
- 输入 `1. ` 后跟文字可以创建有序列表。
- 输入 `> ` 后跟文字可以创建引用块。
- 输入 “ “ 后跟语言名称（可选）可以创建代码块。
- 使用 `/` 呼出斜杠命令菜单，可以快速创建各种块类型（如表格、数学公式、嵌入块等）。
- 编辑块： 点击任何块即可进入编辑模式。使用快捷键或右键菜单可以操作块（复制、剪切、删除、合并、分割、移动等）。
理解与使用“块”
块是 Siyuan Notes 的原子单位。每个块都有一个唯一的 ID。理解块的关键在于：
- 地址： 每个块都可以被独立地寻址和引用。
- 操作： 你可以对单个块进行各种操作，而不仅仅是整个文档。
- 嵌入与引用： 你可以将一个块的内容嵌入到另一个文档中（显示内容并保持同步），或者仅仅创建一个引用链接到该块。
建立连接：双向链接与块引用
- 页面链接： 在任意位置输入 `[[` 即可弹出现有文档列表，选择或输入文档标题即可创建页面链接。如果输入的文档不存在，按下回车会自动创建一个新文档并建立链接。
- 块引用： 输入 `((` 即可搜索并引用任何现有的块。选择要引用的块后，会生成一个以 `((块ID))` 形式显示的引用链接。点击这个链接可以直接跳转到被引用的块。
- 块嵌入： 输入 `{{` 即可搜索并嵌入任何现有的块。被嵌入的块内容会直接显示在当前位置，并且与原块内容保持同步。如果原块内容更新，嵌入的内容也会自动更新。
- 反链面板： 在任意文档或块的右侧，会显示一个反链面板，列出所有链接到当前文档或块的位置。这让你轻松看到你的知识是如何关联起来的。
组织与管理知识
- 笔记本： Siyuan Notes 可以创建多个笔记本，每个笔记本是一个独立的知识库。
- 文档树： 在每个笔记本内部，你可以通过拖拽文档来创建层级结构，形成一个文档树，方便管理和导航。
- 标签： 在块的末尾输入 `#标签名` 来为块添加标签。标签提供了一种灵活的非层级组织方式。
- 属性 (Attributes)： 你可以为文档或块添加自定义属性，例如 `::key value`。这为存储结构化元数据提供了可能，可以用于更高级的查询和组织。
查询与引用块 (Query/Reference Block)
这是一项强大的功能，允许你创建动态的内容列表。你可以根据标签、属性、文档位置、创建/修改时间等条件，查询符合条件的块，并将结果以列表形式显示在一个“引用块”中。这个列表是动态更新的。例如：
输入 `/query`，然后输入查询表达式，例如 `{{:query [[:tag [我的待办]]]` 将显示所有带有“我的待办”标签的块。
这对于创建任务列表、项目概览、收集特定主题的信息等非常有用。
同步数据 (针对多设备或备份)
- 官方同步服务 (Pro 功能)： 如果订阅了专业版，可以在设置中开启官方同步服务，这是最便捷的多设备同步方式。
-
第三方同步工具： 即使使用免费版，你也可以利用第三方同步工具来同步你的工作空间文件夹，实现跨设备访问和数据备份。常用的工具包括：
- Syncthing： 一款开源的P2P同步工具，可以将你的工作空间文件夹同步到你的其他设备上，无需通过中心服务器。
- 云存储服务 + 客户端： 例如 Dropbox, OneDrive, Google Drive 等。将你的工作空间文件夹放在这些服务的同步目录下。需要注意的是，确保在不同设备上不要同时编辑同一个文件，以免引起冲突（尽管 Siyuan 的数据结构在一定程度上缓解了这个问题）。
- Git： 对于有技术背景的用户，可以使用 Git 对工作空间进行版本控制和同步。
无论使用哪种第三方同步方式，都建议先备份数据，并理解其工作原理，以避免数据丢失或冲突。
外观定制
- 主题： Siyuan Notes 支持安装和切换不同的主题，改变应用的外观风格。可以在设置中浏览和应用主题。
- CSS Snippets： 对于更高级的定制，你可以直接编写 CSS 代码片段来修改应用的样式，实现个性化的界面效果。
数据导出
你可以将笔记导出为多种格式，方便分享或迁移：
- Markdown (.md)
- HTML (.html)
- PDF (.pdf)
- 图片 (.png, .jpeg)
- 等等。
导出功能在需要将特定笔记分享给他人或迁移到其他支持这些格式的应用时非常有用。
以上是对 Siyuan Notes 的全方位介绍和使用指南。通过理解并实践这些核心概念和操作，你可以充分发挥 Siyuan Notes 在个人知识管理方面的巨大潜力。
