思源笔记 SiYuan 块折叠完整指南把长文档压缩成可交互的大纲【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan在 SiYuan 里写长文档时光标一旦滑过头部章节整屏内容就铺在眼前找下一处要改的位置全靠滚轮。块折叠就是为这种场景准备的标题左侧的折叠图标可以隐藏整个章节状态自动记忆配合大纲侧栏和递归折叠十万字文档也能整理成一眼能看清的结构。30 秒快速上手把光标放进任意标题块点击标题左侧的折叠图标▾该标题下的所有内容会被隐藏图标变成 ▸。再点一次图标内容恢复展开。不用鼠标也可以光标停在标题上按Ctrl↑macOS 为⌘↑折叠按Ctrl↓⌘↓展开。按AltCtrl↑⌥⌘↑对当前标题做递归折叠它下面所有层级的子标题会一并收起。功能拆解折叠都管得住哪些内容 折叠是写在文档里的不是界面缓存标题折叠后SiYuan 会在该标题及其下方每个块上写入fold: 1和heading-fold属性展开时再移除。这意味着折叠状态存在文档文件本身里而不是某次会话的界面记忆里。效果是你合上电脑明天打开还是原来的结构走数据同步后另一台设备上看到的折叠状态也一致。相关逻辑在 kernel/model/heading.go 的doFoldHeading与doUnfoldHeading中。⚡ 展开一个标题顺带做两件事展开折叠标题时内核会顺带处理两件事一是如果这个标题还套在另一个折叠标题里面上方那个也会被一并解开避免解了外层、内容还藏在里层的错位二是重新计算并显示块下的引用计数。所以你展开一个章节后立刻能看到该章节被其他文档引用了多少次不需要手动刷新。️ 与大纲侧栏的双向联动按⌥O打开大纲侧栏里面列出文档所有标题。点击某个标题直接跳到正文对应位置在侧栏对标题做展开、折叠正文实时跟着变反过来也一样。大纲侧栏的展开范围是每个文档单独记一份的内核在OutlineInBox里优先读取该文档保存的展开 ID 列表expandIds没有记录时才默认全部展开。你昨天把大纲收窄到两个章节今天再打开这份文档侧栏还是那个样子。进阶组合把折叠串进别的功能折叠 标题转文档某个章节写到上万字、拖慢整份文档时在块菜单里把它转为文档拆出去。内核对折叠标题做了专门处理见 kernel/model/heading.go 中Heading2Doc转换时会自动展开被折叠的下方块内容一条不少地迁进新文档不会拆完发现少了一半。折叠 块缩进聚焦临时查看某一段的上下文时不必先折叠一大片再用。光标进入块后直接用块缩进功能把该块放大为独立视图看完切回来整体折叠结构保持原样。两者分工折叠管长期结构块缩进管临时聚焦。递归折叠 全文速览用AltCtrl↑把所有章节一次性收掉文档瞬间只剩一列标题相当于现成的目录页。适合改完结构后快速检查章节命名和层级是否合理。一条完整工作流整理万字项目复盘以一份包含背景、过程、问题、结论四个章节的复盘文档为例在空行输入#加空格创建一级标题把四个章节先立起来。光标停在背景标题上按Ctrl↑折叠它之后只在过程章节里写。按⌥O打开大纲侧栏写作中随时点标题跳回对应章节不用来回滚动。问题章节写完但暂时不想细看时按AltCtrl↑递归折叠只留章节名。过程章节超过一万字后在它的标题块菜单里选择转为文档内核自动展开折叠内容完整迁出成独立文件。隔天重新打开文档四个章节的折叠状态、大纲侧栏的展开范围都和上次离开时一致直接从断点继续。提示快捷键都能在 设置 快捷键 里改改完后建议按新的肌肉记忆固定下来避免混用两套按键。避坑速查现象原因处理展开某标题后里面的小节仍然是收起的每一级标题各自独立折叠展开外层不会自动展开内层子标题把光标移到内层标题上再按一次Ctrl↓或用递归展开逐步打开列表项下第一个块找不到块图标没法折叠列表项的第一个子块会省略显示块图标这是有意设计光标移入该块按Ctrl/触发块菜单操作把折叠标题转为文档后原章节空了转为文档是把整段内容迁走不是复制折叠属性在迁移时会被自动清除这是预期行为。确认新文档里内容完整即可不要误以为丢数据延伸阅读块折叠看起来只是藏了点内容实际上它让长文档变成一份可以随时收放、状态永不丢失的交互大纲。想查接口细节可以翻 docs/API.zh-CN.md快捷键默认值集中在 app/src/constants.ts 的editor.general段里动手前对照一眼最省事。【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 思源笔记 SiYuan 块折叠完整指南：把长文档压缩成可交互的大纲
思源笔记 SiYuan 块折叠完整指南把长文档压缩成可交互的大纲【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan在 SiYuan 里写长文档时光标一旦滑过头部章节整屏内容就铺在眼前找下一处要改的位置全靠滚轮。块折叠就是为这种场景准备的标题左侧的折叠图标可以隐藏整个章节状态自动记忆配合大纲侧栏和递归折叠十万字文档也能整理成一眼能看清的结构。30 秒快速上手把光标放进任意标题块点击标题左侧的折叠图标▾该标题下的所有内容会被隐藏图标变成 ▸。再点一次图标内容恢复展开。不用鼠标也可以光标停在标题上按Ctrl↑macOS 为⌘↑折叠按Ctrl↓⌘↓展开。按AltCtrl↑⌥⌘↑对当前标题做递归折叠它下面所有层级的子标题会一并收起。功能拆解折叠都管得住哪些内容 折叠是写在文档里的不是界面缓存标题折叠后SiYuan 会在该标题及其下方每个块上写入fold: 1和heading-fold属性展开时再移除。这意味着折叠状态存在文档文件本身里而不是某次会话的界面记忆里。效果是你合上电脑明天打开还是原来的结构走数据同步后另一台设备上看到的折叠状态也一致。相关逻辑在 kernel/model/heading.go 的doFoldHeading与doUnfoldHeading中。⚡ 展开一个标题顺带做两件事展开折叠标题时内核会顺带处理两件事一是如果这个标题还套在另一个折叠标题里面上方那个也会被一并解开避免解了外层、内容还藏在里层的错位二是重新计算并显示块下的引用计数。所以你展开一个章节后立刻能看到该章节被其他文档引用了多少次不需要手动刷新。️ 与大纲侧栏的双向联动按⌥O打开大纲侧栏里面列出文档所有标题。点击某个标题直接跳到正文对应位置在侧栏对标题做展开、折叠正文实时跟着变反过来也一样。大纲侧栏的展开范围是每个文档单独记一份的内核在OutlineInBox里优先读取该文档保存的展开 ID 列表expandIds没有记录时才默认全部展开。你昨天把大纲收窄到两个章节今天再打开这份文档侧栏还是那个样子。进阶组合把折叠串进别的功能折叠 标题转文档某个章节写到上万字、拖慢整份文档时在块菜单里把它转为文档拆出去。内核对折叠标题做了专门处理见 kernel/model/heading.go 中Heading2Doc转换时会自动展开被折叠的下方块内容一条不少地迁进新文档不会拆完发现少了一半。折叠 块缩进聚焦临时查看某一段的上下文时不必先折叠一大片再用。光标进入块后直接用块缩进功能把该块放大为独立视图看完切回来整体折叠结构保持原样。两者分工折叠管长期结构块缩进管临时聚焦。递归折叠 全文速览用AltCtrl↑把所有章节一次性收掉文档瞬间只剩一列标题相当于现成的目录页。适合改完结构后快速检查章节命名和层级是否合理。一条完整工作流整理万字项目复盘以一份包含背景、过程、问题、结论四个章节的复盘文档为例在空行输入#加空格创建一级标题把四个章节先立起来。光标停在背景标题上按Ctrl↑折叠它之后只在过程章节里写。按⌥O打开大纲侧栏写作中随时点标题跳回对应章节不用来回滚动。问题章节写完但暂时不想细看时按AltCtrl↑递归折叠只留章节名。过程章节超过一万字后在它的标题块菜单里选择转为文档内核自动展开折叠内容完整迁出成独立文件。隔天重新打开文档四个章节的折叠状态、大纲侧栏的展开范围都和上次离开时一致直接从断点继续。提示快捷键都能在 设置 快捷键 里改改完后建议按新的肌肉记忆固定下来避免混用两套按键。避坑速查现象原因处理展开某标题后里面的小节仍然是收起的每一级标题各自独立折叠展开外层不会自动展开内层子标题把光标移到内层标题上再按一次Ctrl↓或用递归展开逐步打开列表项下第一个块找不到块图标没法折叠列表项的第一个子块会省略显示块图标这是有意设计光标移入该块按Ctrl/触发块菜单操作把折叠标题转为文档后原章节空了转为文档是把整段内容迁走不是复制折叠属性在迁移时会被自动清除这是预期行为。确认新文档里内容完整即可不要误以为丢数据延伸阅读块折叠看起来只是藏了点内容实际上它让长文档变成一份可以随时收放、状态永不丢失的交互大纲。想查接口细节可以翻 docs/API.zh-CN.md快捷键默认值集中在 app/src/constants.ts 的editor.general段里动手前对照一眼最省事。【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考