修改思源笔记标题块的嵌入块逻辑

PR

标题块的嵌入块支持隐藏标题 by Achuan-2 · Pull Request #15877 · siyuan-note/siyuan

改进背景

PixPin20250920113009.png

个人使用嵌入块,一般使用标题块来嵌入,原因

  • 用目录大纲来管理有明确主题的卡片笔记比较轻松,不需要拆分一个个文档,增加管理压力,知识点可以汇聚,方便渐进式增删与修改(琐碎的不成体系的知识点还是会以卡片文档的形式记录)
    PixPin20250920113509.png
  • 标题块相比普通块的 id 更加稳定,嵌入块不容易因为误操作丢失 id(比如列表项块转段落块就会丢失 id)

但是思源标题块的嵌入块有如下问题

  • 标题块的嵌入目前默认显示标题,然而标题并不在标题大纲显示,只有导出时才显示
  • 标题块的嵌入块在导出层级上不方便控制层级,靠导出时嵌入块的标题转换其实非常难用,目前只适合把嵌入块作为当前标题的子标题来用,但是如果需要嵌入块的内容是顶级标题,就无法实现(因为这种需求只能靠嵌入块前没有标题才能实现,正常写作场景基本无法满足这个要求)
  • 标题块的嵌入块导出时默认带标题,导致我无法自己手动加标题,因为原标题不一定满足当前写作输出的需求

考虑到目前标题块的嵌入块显示标题,不灵活不好用

因此建议标题块的嵌入块需要支持隐藏标题,可以选择作为非标题块嵌入当前笔记,也可以手动添加需要的标题层级,实现更灵活的块嵌入写作体验

改进结果

PixPin20250920113055.png

嵌入块添加标题嵌入设置,显示一个下拉框,支持设置下面三个选项

  • 显示标题与下方的块
  • 仅显示标题
  • 仅显示标题下方的块(默认)

原来:显示标题与下方的块

PixPin20250920113009.png

现在:仅显示标题下方的块

PixPin20250920113147.png

导出预览和导出 pdf、word、markdown 都会生效

导出预览

PixPin20250920113158.png

导出 pdf

PixPin20250920113301.png

  • 思源笔记

    思源笔记是一款隐私优先的个人知识管理系统,支持完全离线使用,同时也支持端到端加密同步。

    融合块、大纲和双向链接,重构你的思维。

    28446 引用 • 119783 回帖
1 操作
Achuan-2 在 2025-09-20 11:49:29 更新了该帖

相关帖子

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...
Achuan-2
公众号:https://mp.weixin.qq.com/s/_NrGwjJnEta0oT5a6EKdiA 知乎:https://www.zhihu.com/column/c_1922583788405359964 上海