企业官网建设流程全解析

思源笔记块折叠：3 级操作 + 2 套工作流，长文档终于不乱了

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

写到第 30 页，忽然要找第 5 页的结论，滚轮滚到指尖发麻，最后发现那一页早被自己折起来了。思源笔记的块折叠就是解决这件事的：每个内容块都能单独收起和展开，长文档瞬间缩成一棵清晰的大纲，想看哪段再点开哪段。块折叠到底有哪些顺手用法？

传统编辑器的折叠和思源笔记块折叠差在哪

这块能力对这几类人最有用：

• 写长篇技术文档的人
• 维护个人知识库的人
• 精读论文和报告的人
• 管项目待办和纪要的人

折叠逻辑在 heading.go 里有完整实现，你平时只要会用就行。

鼠标、键盘、大纲：三级折叠操作

第一级：点一下块左侧的折叠图标

把鼠标悬停到标题或列表项上，左侧会出现 ▸/▾ 小图标，点一下收起，再点一下展开。对标题块生效时，它下面所有子块一起藏起来，文档树里的层级也随之收拢。

💡 文档树里的笔记本目录也有折叠图标，和块折叠互不干扰，别点错位置。

第二级：4 个折叠快捷键背下来

默认值定义在 constants.ts，去设置 > 快捷键 > 编辑器就能改成你自己的习惯。

第三级：级联折叠与大纲视图联动

按住Alt点击折叠图标，可以级联折叠：当前块下面所有层级的内容一次收光，对层级很深的笔记特别省事。左侧大纲面板（⌥O打开）顶部有折叠按钮，右键任一标题还能选"折叠所有子级""折叠所有同级项""全部展开"。

大纲和编辑器双向同步：你在大纲里折掉的标题，编辑器里对应子块立即收起；反向也一样。而且折叠状态会持久化，重新打开同一篇文档，之前折好的层级原样恢复。

⚡ 逐层收用⌘↑，一键收光用Alt点击，两者配合大纲的"折叠所有同级项"，可以快速聚焦到任意一章。

两个真实工作流拆解

场景 A：精读一篇长论文

1. 全文导入后，把摘要、致谢等章节用折叠图标收起，只留章节骨架。
2. 在大纲面板点击要精读的章节标题，编辑器直接跳过去聚焦。
3. 精读时按⌘↑逐层收起子级，读完一层再展开下一层。
4. 把关键段落做块引用，抽出来拼成自己的摘要笔记。

场景 B：管理项目待办与会议纪要

1. 一级标题建"任务"和"会议记录"，任务下用列表缩进出多级子任务。
2. 完成一条子任务就点它左侧图标折掉，待办事项一眼可见。
3. 用属性视图按状态筛选任务，看板布局下拖一下就能改状态。
4. 导出或分享报告时，折好的章节保持收起，输出直接是精简版。

属性视图的实现在 av.go，筛选和折叠配合使用，会议记录不再是一锅粥。

你可能踩的 3 个坑

以为折叠等于删除，内容"消失"了

现象：一折叠，整段内容没了，慌了。原因：折叠只是视觉隐藏，数据一个字节都没少。解法：30 秒内按Ctrl+Z撤销；如果确认只是折错了，再点一次图标就回来了，万一只误操作过文档，还能到workspace/history/目录找回历史版本。

超长文档折叠卡顿，掉帧明显

现象：十万字以上频繁折叠，光标跟着掉帧。原因：大文档一次性渲染，折叠展开都要重算布局。解法：两个设置项救场。一是在设置 > 编辑器里打开延迟加载，让块懒渲染；二是把大文档拆成几篇小文档，用块引用串起来，单次折叠的负担就小了。

代码块折叠后为什么保留首尾行

现象：别的块折成一行，代码块却留着首尾两行。原因：这是设计意图，不是 bug——保留首尾行让你在不展开的情况下确认代码边界，结构始终可见。解法：长代码文件想只看结构就放心折，想看细节再点一下展开即可。

一句话总结 + 延伸阅读

把长文档折成一棵能随时收放的树，这就是块折叠的全部价值。

• 官方 README：README.md
• API 手册：API.md，写插件时控制折叠会用到

💬 有独家的折叠用法？去思源社区讨论区分享你的经验，或把你的卡点贴出来等解答。

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