Documentation map
The docs are organised in seven groups and 27 pages: get it running, understand the model, then look up details. Every page answers one concrete question; if you are unsure where to start, use the problem index below.
Learning order
Getting started
| Page | Answers |
|---|---|
| Install | How to install and where to find it |
| Quick start | How to write the first gallery row |
| Core concepts | Galleries, rows, width, float, crop |
Galleries
| Page | Answers |
|---|---|
| Grouping | Which images become one row |
| Row splitting | How many per row, and how to pin 5+2 |
| Row height and orphans | Why a row is capped, why one image leaves |
| Gallery handles | Column drag, row drag, swap, merge, lock |
Single images
| Page | Answers |
|---|---|
| Width routing | Default width, and when an image centres |
| Float and wrap | Why text wraps, and where a float ends |
| Resize, align, reset | Corner drag, left/right alignment, reset |
Annotations and crops
| Page | Answers |
|---|---|
| Annotation syntax | ag: in alt text or on its own line |
| Cropping | How ag:crop and ag:top combine |
| Nested scopes | Lists, tables and callouts ownership |
| Dialog and reset | What the dialog writes, what reset clears |
Templates and routing
| Page | Answers |
|---|---|
| Layout templates | Reusing a whole width rhythm |
| Import and export | Backing up, sharing and merging profiles |
| Frontmatter routing | Switching rhythm per note |
PDF export
| Page | Answers |
|---|---|
| Export dialog | Paper, margins and page numbers |
| Pagination | The five pagination rules |
| Troubleshooting | Blank pages, missing images, fonts |
Reference
| Page | Answers |
|---|---|
| Settings | Every switch, default and effect |
| Commands | Commands and where to trigger them |
| Compatibility | Obsidian versions, themes, mobile |
| Pitfalls | Why "it did not take effect" |
| Changelog | What changed in each version |
Find by symptom
| Symptom | Start with |
|---|---|
| Images did not form a row | Grouping |
| A row split unexpectedly | Row splitting, Row height |
| An image is not as wide as expected | Width routing |
| Text does not wrap beside an image | Float and wrap |
| Crop looks wrong | Cropping |
| Images inside a list or table misbehave | Nested scopes |
| A template change did nothing | Layout templates, Routing |
| PDF has blank pages or split images | Pagination, Troubleshooting |
Conventions
- "Gallery" means the rows rendered from one contiguous image run, not the Obsidian gallery plugin.
ag:parameters are case-sensitive; ratios use16:9, never16/9.- Every example comes from the bundled
demo/anddemo-en/vaults, ready to open side by side.