分组:什么算一行
同一组内的图片共用一条行高。分组由源码中的空行与结构决定,最多允许两个空行。
规则表
| 两张图之间 | 结果 |
|---|---|
| 0 个空行 | 同一组 |
| 1 个空行 | 同一组 |
| 2 个空行 | 同一组(上限) |
| 3 个空行 | 分成两组 |
| 一行正文 | 分成两组 |
| 一个标题 | 分成两组 |
连续写入三行图片时,渲染结果为一行三格:
markdown



空行在画面上看不见
阅读视图会丢弃空行,因此 0 个、1 个、2 个空行在画面上的间距完全一致,但插件得到的分组结果不同。判断分组时应统计源码空行,不应依据画面留白。
第三个空行才会真正断开分组:
markdown



上图中 J 独占一行,K 与 L 并排。差异仅来自 J 与 K 之间增加的第三个空行。
正文是不需要空行的分隔符
两张图片之间插入任意一行非空文本,分组立即结束,与空行数量无关:
markdown

这一行正文会结束当前分组。

因此,在两张图片之间添加图注说明会导致它们不再并排。若需保留并排并补充说明,应将说明置于整组之后。
标题同样是边界
## 与 ### 标题都会结束当前分组,且不会被并入上一行。同一主题的多张图片应置于同一小节内,避免跨小节分组。
强行让某张图单独成行
| 写法 | 结果 | 图注 | 是否由插件接管 |
|---|---|---|---|
| 前后加正文 | 单独一组 | 保留 | 是 |
ag:isolate | 单独一组,并切断前后 | 保留 | 是 |
ag:exclude | 交给 Obsidian 原生渲染 | 不显示 | 否 |
ag:isolate 与 ag:exclude 的区别需要明确:前者仍由插件计算宽度并执行路由,但不参与画廊;后者完全不由插件接管,连图注也不显示。完整参数见参数语法。
常见误判
- “空了三行仍未分开”:统计的是渲染后的视觉空白,而非源码行。应切换到源码模式确认。
- “两张图紧挨着却没有并排”:其中一张可能写入了
ag:exclude,或两张图位于列表的不同条目中。 - “加了一句说明就不并排了”:正文是分隔符。应将说明移至整组之后,或改用图注。