Skip to content

AutoGalleryLet your Markdown images lay themselves out

Galleries, floats, cropping and PDF export — built on the image links you already have

A page first ​

One ordinary note scrolling from top to bottom: galleries, right-hand floats with wrapping text, a crop comparison and two image groups with different rhythms. The source contains no pixel sizes at all.

AutoGallery does not invent new Markdown syntax: it reads your existing image links and decides how wide each image is, which row it belongs to, whether it floats, and which part of the picture to show.

markdown
![Fjord](assets/photo/01-fjord.jpg)
![Falls](assets/photo/05-falls.jpg)
![Ridge](assets/photo/02-ridge.jpg)

Three ordinary links render as one row of three equal-height cells — the file itself is untouched. Disable the plugin and they fall back to their original sizes, stacked.

Install ​

bash
# Community plugins: Settings → Community plugins → Browse → search AutoGallery
# Or drop the files in manually:
<your vault>/.obsidian/plugins/obsidian-autogallery/{main.js,manifest.json}

Full steps are in Install. To see it first, download the English demo vault or the Chinese one: a complete vault with the plugin installed and a chapter per feature.

Where to go ​

GroupStart hereWhat you get
Getting startedQuick startYour first gallery row
GalleriesGroupingWho shares a row
Single imagesWidth routingHow wide one image is
Parameters and croppingParameter syntaxThe ten parameters
Templates and routingLayout templatesA whole width rhythm
PDF exportExport dialogA readable print
ReferenceSettingsEvery switch

When something "was written but did not apply", check Pitfalls first.