Install
AutoGallery needs Obsidian 1.5 or newer. It works on desktop and mobile.
From the community plugins
- Open Settings → Community plugins and turn off Restricted mode.
- Choose Browse and search for AutoGallery.
- Install and enable it.
Manually
- Download
main.jsandmanifest.jsonfrom Releases. - Put them in
<your vault>/.obsidian/plugins/obsidian-autogallery/. - Restart Obsidian and enable AutoGallery under Community plugins.
The plugin keeps its data inside your vault; the only exception is an external profile path you configure yourself. Disabling it restores Obsidian's original image markup.
Three things to check after enabling
| Check | Expected |
|---|---|
| A section named "AutoGallery" appears in settings | the plugin loaded |
| Write two or three image lines in a row | they become one equal-height gallery |
| Search "AutoGallery" in the command palette | four commands appear |
If any check fails, read Compatibility first, then Pitfalls.
See it first: the demo vault
- Download the English demo vault zip. The Chinese vault is here.
- Unzip it anywhere.
- In Obsidian, choose Open folder as vault and pick that folder.
- When Restricted mode is mentioned, trust the author so the bundled plugin can load.
The vault ships with the plugin and a frozen baseline, so every example works on first open. It contains no screenshots or recordings; those live in this site. Release-pinned zips are autogallery-demo-en-*.zip (English) and autogallery-demo-*.zip (Chinese).
Disable and uninstall
Disabling the plugin immediately restores Obsidian's original image markup and styling — it never changes the Markdown file structure, only the ag: parameters inside image captions. To remove those as well, run Restore document default image style in each note before disabling.