\_summary标签的值即为折叠面板标题文字，须作为标签自身文本内容直接书写，不可作属性或嵌套使用，且需确保所在环境（如obsidian插件）明确支持该非标准标签。
折叠面板标题文字怎么写进 _SUMMARY 标签
直接把要显示的标题文本作为 _SUMMARY 标签的值即可，它不是属性也不是子节点，而是标签自身的文本内容。常见错误是把它当 HTML 属性写成 <_summary title="xxx"></_summary>，或者嵌套其他标签——这会导致渲染失败或文字不显示。
实操建议：
-
_SUMMARY必须是折叠面板容器（如<details></details>或某些 UI 库的自定义组件）的直接子标签，且只能有一个 - 文本中可含空格、中文、emoji，但避免换行符和未转义的
<code>>，否则被解析为非法 HTML - 若用在 Markdown 渲染环境（如 Obsidian、Typora），需确认其解析器支持该标签；原生 HTML 中需配合
<details><summary></summary></details>使用，此时_SUMMARY是非标准写法，仅部分插件识别
为什么有些 _SUMMARY 文字不显示
根本原因通常是上下文不匹配：这个标签本身不是 HTML 标准元素，它的行为完全取决于所用框架或解析器。比如在 Obsidian 的 Dataview 插件里，_SUMMARY 仅在特定代码块（如 ```dataview）中作为元数据字段生效；而在纯 HTML 页面里，浏览器会忽略它，除非有 JS 主动读取并插入 DOM。
排查要点：
- 检查当前环境是否明确文档支持
_SUMMARY—— 比如 Obsidian 社区插件说明页、或组件库 API 文档 - 确认标签位置：必须紧贴折叠容器起始标签下方，无空行或注释隔开（部分解析器对空白敏感）
- 查看控制台是否有警告，例如
Unknown tag: _SUMMARY，说明解析器跳过了它
_SUMMARY 和原生 <summary></summary> 的关系
二者目的相同，但层级不同：<summary></summary> 是 HTML5 原生语义标签，用于 <details></details> 内部，由浏览器直接渲染；_SUMMARY 是约定俗成的元数据标记，常用于预处理场景（如 Markdown 转 HTML 时提取标题）。
关键差异：
- 兼容性：
<summary></summary>在所有现代浏览器中开箱即用；_SUMMARY需额外解析逻辑，否则只是普通文本 - 样式控制：
<summary></summary>可用 CSS 选中（如details > summary）；_SUMMARY默认无样式，需 JS 提取后手动挂载到 DOM 并添加 class - 交互响应：
<summary></summary>点击自动切换<details></details>的open状态；_SUMMARY本身无交互能力，必须配 JS 绑定事件
实际用例：Obsidian 中让 _SUMMARY 生效
Obsidian 的「折叠区块」功能（需开启社区插件或使用 Templater）依赖 _SUMMARY 提取标题。正确写法如下：
```fold _SUMMARY 项目进度汇总 - 本周完成接口联调 - 下周启动压力测试 ```
注意点：
-
_SUMMARY后必须紧跟一个空格，再写文字；写成_SUMMARY:xxx或_SUMMARY=xxx无效 - 整段代码块类型必须是
fold（或插件指定的其他关键字），不能是javascript、text等 - 如果用了多个插件（如 Outline + Fold Headings），优先级可能冲突，导致
_SUMMARY被忽略
复杂点在于：_SUMMARY 不是通用标准，它像一把钥匙，只对特定锁有效。漏看插件文档、错放位置、混用语法，都会让它彻底“隐形”。
