文档地图
本文档按“先运行、再理解、后查阅”组织，共七组 27 页。每页回答一个具体问题；如不确定从何处开始，可先查阅下方的按问题索引。
按学习顺序
开始使用
| 页面 | 回答的问题 |
|---|---|
| 安装与启用 | 插件怎么装、装完在哪里 |
| 五分钟上手 | 怎样写出第一行画廊 |
| 五个核心概念 | 画廊、行、宽度、浮动、裁剪分别是什么 |
画廊
| 页面 | 回答的问题 |
|---|---|
| 分组：什么算一行 | 哪些图片会被并成一行 |
| 行切分与混合比例 | 一行放几张、怎么指定 5+2 |
| 行高上限与孤儿 | 行高为什么被压、单图为什么离开画廊 |
| 画廊手柄 | 拖列宽、拖行高、交换、并入、锁定 |
单图
| 页面 | 回答的问题 |
|---|---|
| 宽度路由 | 一张图默认占多宽、什么时候居中 |
| 浮动与绕排 | 文字为什么绕到图片旁边、浮动到哪里结束 |
| 拖宽、对齐与复位 | 拖角标、左右对齐、恢复初始状态 |
参数与裁剪
| 页面 | 回答的问题 |
|---|---|
| 参数语法 | ag: 写在 alt 里还是单独一行 |
| 裁剪与取景 | ag:crop 与 ag:top 怎么配合 |
| 嵌套作用域 | 列表、表格、callout 里的图片归谁管 |
| 说明对话框与重置 | 对话框改了什么、重置的范围 |
模板与路由
| 页面 | 回答的问题 |
|---|---|
| 布局模板 | 一套宽度规则怎么复用 |
| 导入与导出 | 模板怎么备份、分享、合并 |
| Frontmatter 路由 | 同一批图怎么按笔记切换节奏 |
PDF 导出
| 页面 | 回答的问题 |
|---|---|
| 导出对话框 | 纸张、边距、页码在哪里设 |
| 分页优化 | 五条分页规则分别做什么 |
| 失败与排查 | 导出失败、空白页、字体异常怎么查 |
参考
| 页面 | 回答的问题 |
|---|---|
| 设置项总表 | 每个开关的默认值与影响 |
| 命令与入口 | 有哪些命令、从哪里触发 |
| 兼容性 | Obsidian 版本、主题、移动端 |
| 容易误解的行为 | 为什么“写了却没生效” |
| 更新日志 | 每个版本改了什么 |
按问题找
| 现象 | 先看 |
|---|---|
| 图片没有并成一行 | 分组规则 |
| 一行被拆成两行 | 行切分、行高上限 |
| 图片没有按预期变宽 | 宽度路由 |
| 文字没有绕到图片旁边 | 浮动与绕排 |
| 裁剪后画幅不对 | 裁剪与取景 |
| 列表或表格里的图片失控 | 嵌套作用域 |
| 模板改了但没生效 | 布局模板、Frontmatter 路由 |
| PDF 出现空白页或断图 | 分页优化、失败与排查 |
约定
- 正文里的「画廊」指同一条连续图片序列渲染出的一行或多行，不是 Obsidian 的 gallery 插件。
ag:参数区分大小写；值里的比例写成16:9，不要写16/9。- 所有示例都来自随插件发布的
demo/与demo-en/演示库，可以直接打开对照。