思源笔记结构分析

为了帮助新手更好地理解和使用思源笔记，本文将介绍思源笔记的基本结构，主要包括“库”、“本”、“页”和“块”，并展示如何高效管理笔记。

一、思源笔记基本结构

思源笔记的结构可以类比于活页本，整体界面呈现出“库、本、页、块”的层次划分：

1、库

在思源笔记中，库被称作“工作空间”。在文档树面板上，笔记库包含了打开的笔记本和已关闭的笔记本，后续将详细说明。

2、本

即笔记本，显示为文档树/结构面板的第一级。

3、页

是笔记页，官方称之为“文档”。它们是笔记本下的若干子项，可以存在同级或上下级关系。

4、块

指的是编辑窗口中页面的各类内容，通常称为内容块（每个块都有其独特的ID）。

一个硬回车即会生成一个新的块。使用 Shift + Enter 则可以生成软回车换行，而上下行内容仍会归属于同一个块。

在更广义的定义中，思源笔记的笔记库还包括被删除的笔记本、本地资源、emoji、自定义构件和模板等数据。整个笔记库包含了打开的笔记本、关闭的笔记本、已删除的笔记本及本地资源等。

笔记库可对应到电脑硬盘上的文件，即在安装思源笔记时自动创建的 “Siyuan/data” 目录；
本地资源（如图片）存放在 “assets” 目录中；
可以在设置菜单中查看工作空间目录的具体路径；
用户可以在“我的电脑”中对工作空间目录进行重命名或新建，并在思源笔记设置中更新路径。

需要注意的是，笔记库的底层文件结构主要使用 “.sy” 文件，这些文件实际上是 JSON 格式。思源笔记使用 JSON 组织数据，以支持更丰富的功能扩展，而不是像 Obsidian 那样使用 Markdown 文件。虽然可以用文本编辑器打开 “.sy” 文件进行有限的编辑和查找替换，但建议用户谨慎操作。

二、新建位置

默认情况下，新建的笔记页（文档）会放在当前笔记本或笔记页的下一级。如果希望将新建的笔记页放在特定位置，可以通过右键点击某一笔记本名称，选择“设置”，进而设定“块引新建笔记页存放位置”。例如：在设置中输入 “((/folder1/folder2/)”，不以 “/” 开头则会使用当前笔记页的相对路径，设置好后，下次新建的笔记页将被存放在指定位置。

三、文档排序

在文档树面板中，当前版本的思源笔记不支持通过鼠标拖动来手动排序同级文档。同样，用户也无法批量选择多个笔记页进行拖动操作。

目前仅支持对全部笔记本进行排序，可通过文档树面板右侧的“…”按钮进入“排序”菜单，选择需要的排序方式。如果打开了多个笔记本，则无法针对某一笔记本单独进行排序。

为了更好地组织笔记页/文档结构，用户可选择以下两种方式之一：

1、将全部内容放入一个页面中，使用层级标题，并在大纲面板中进行跳转。

2、在父文档中使用 MOC，以所需的顺序排列相关子文档的跳转链接。

四、文档层级与大纲

在文档树面板，A 页与 B 页若处于同一级，可以把 A 页拖动至 B 页下方，使其成为 B 页的子页；若要让 A 页恢复为同级，则向 B 页的上一级拖动即可。大纲面板显示当前页的标题级次结构，和其他 Markdown 笔记软件的大纲显示类似；
大纲的优点是显示当前页的层次结构，方便快速定位某一层级位置；
大纲面板的快捷键是Alt+2 ；
如果大纲层级标题过长，鼠标划过可浮现完整标题（2.0.17），不必调整窗口宽度；
大纲还可以单独呼出页签，按 Alt + o (opq 的 o) 可以弹出大纲页签。

五、页块互转

文档树面板中的笔记页可以往编辑窗口某个块上拖放，转换成层级标题。编辑页面内的层级标题也可以往文档树面板中的某一笔记本或某一笔记页上拖放，组成树状层级的一部分。注意如果想拖拽标题块和所属段落内容，需要将其折叠后才能一起拖拽。

六、拆分合并

思源笔记目前没有将笔记页内层级标题拆分为子页/子文档的功能，如果是长期使用过程中形成的较长的笔记页（文档），要拆分只能通过页块拖动的方式，一个一个来。两个笔记页合并，可拖动一个笔记页（文档）到另一个笔记页（文档）页面某个位置。这个就是上面说的页块互转。如果是多页合并，就多拖几次。

七、导入导出

1、笔记页

思源笔记2.0.12开始可以打包导入导出笔记页的.sy文件。笔记页可以导入md文件，可点击某一笔记本名称、某一笔记页名称的右侧三点图标（更多），选择导入。导入的位置就是你选择的“本”或“页”的下一级。导入只支持 Markdown 文件，或有 Markdown 文件的文件夹。

这里需要注意一下md大文档的导入问题：

如果导入的单个 Markdown 文件很长，建议导入前先用文本工具按章节拆分成若干部分；
思源笔记现在无法在导入 md 文件时自动按标题拆分文档，编辑页面也无法将一个长页面中的若干层级标题自动转换为若干小的笔记页；
大文档、长文档涉及文字编辑和块操作的效率问题，详见本文的“编辑——全选操作”以及“编辑——块操作”部分；
可以用 Obsidian + 它的 Note Refactor 插件快速拆分，导入前如需合并，也用Obsidian合并好再导入。

笔记页导出md比较方便：

导出为 Markdown 时，形式是通过浏览器下载一个 zip 包，效率上比较不便。这其中有针对包含图片文档的考虑；
笔记页导出时可以用 Ctrl+Alt+9 / Cmd+Alt+9 预览 Markdown 效果，并可以选择复制到微信公众号、知乎、语雀（注意目前 Ctrl+A /Cmd+A不能全选，见本文的编辑>全选操作中的讨论）。