容易误解的行为
十六条“看似缺陷、实为设计取舍”的结论。按症状查表，第三列是正确做法。
| # | 现象 | 正确做法 |
|---|---|---|
| 1 | 调了 ag:gap，画廊格子之间的距离没变 | ag:gap 只改浮动图与正文的间距；画廊间距在设置页「画廊图片间距」 |
| 2 | 画廊里给某张写了 ag:width，完全没效果 | 两张以上连续图片一定是画廊，逐张的 layout / width / side 都被忽略；要单图控制先 ag:isolate 或用正文断开 |
| 3 | 一张图独占一行，却占满了整栏 | 单图行仍是画廊格，占满栏宽；想变窄写 ag:width，或依赖孤儿规则 |
| 4 | ag:top 写好了，改一次参数就消失了 | ag:top 必须与 ag:crop 同时存在，没有 crop 时重写会丢弃它 |
| 5 | 表格里的 ag:width 不生效 | 表格单元格只认 ag:crop 与 ag:exclude；宽度由表格决定 |
| 6 | callout 里放两张图，它们没有并排 | callout 只被认领、不被装饰，保持 Obsidian 原生样式 |
| 7 | 列表里两张紧挨着的图没有成行 | 它们属于不同的列表项；并排只发生在同一个 li 内 |
| 8 | 实时预览里文字没有绕到图片旁边 | 实时预览不做正文绕排；验证绕排用阅读视图 |
| 9 | 两张图之间空了很多行，仍然并排 | 空行上限是 2；第 3 个空行才断开。空行在阅读视图里不可见，容易误判 |
| 10 | 把孤儿上限调成 1200，竖图还是跳出去了 | 判断依据是渲染后的整栏高度，不是原图像素高度 |
| 11 | 写 ag:width=95% 有效，却担心有 90% 上限 | 合法区间是 10%–100%；100% 表示满栏居中，参数仍保留 |
| 12 | 模板里写 min(0.6, r)，规则没生效 | 表达式只放行 Math.*；写 Math.min(0.6, r)。非法规则会被静默丢弃 |
| 13 | frontmatter 写 album: Trip，路由不命中 | 路由是精确字符串比较，Trip ≠ trip；键值都保持小写 |
| 14 | ag:rows 指定的行没有遵守最小行高 | 手动指定的切分有意跳过 galleryMinHeight，以写入的分法为准 |
| 15 | PDF 里一整行画廊被拆到了两页 | 不会拆；若看到「拆开」，通常是两行画廊被误读成一行，检查空行与正文 |
| 16 | 切到「版式预览」看不到分页 | 版式预览是连续长页，不分页；要看页边界切「分页预览」（会真打印） |
另外四条
- 设置页不能新建模板，也不能编辑规则：只能导入、导出、删除，以及改名称与浮动方向。规则必须通过导入
.json写入。 - 画廊格没有右下角调宽角标：格子宽度由整行共同决定，改列宽要拖两格之间的分隔条。
ag:isolate与ag:exclude不一样：前者仍由插件接管布局、保留图注；后者完全交回 Obsidian、不显示图注。- 裁剪会改变宽度：插件用的是裁剪后的比例，所以裁成方形会让图片变窄。
判断是否为插件问题
- 把这张图写成单独一段，看行为是否变化；变了说明是分组问题。
- 切到阅读视图再看一次；变了说明是视图差异（绕排）。
- 检查有没有
ag:参数；有参数时模板不生效。 - 在设置页把相关项恢复默认；变了说明是设置问题。