Repository navigation
Releases
AutoGallery 1.0.4
AutoGallery 1.0.4 — automatic image layout for Obsidian.
简介
AutoGallery 处理 Obsidian 笔记里的图片排版:连续图片自动排成等高画廊,单图按比例取宽并支持文字绕排,裁剪只记录比例,PDF 导出与阅读视图保持一致。
它不改写 Markdown 图片链接,也不写入像素尺寸;效果来自图片说明里的 ag: 参数与可导出的布局模板。停用插件后,笔记仍按原生方式显示。
- 画廊 — 相邻图片自动成行,支持拆行、锁定、行高上限与五种拖拽手柄。
- 单图 — 按比例取宽,左右浮动绕排,拖拽调整宽度,对齐箭头与一键重置。
- 图注与裁剪 — 十个
ag:参数、按比例裁剪、嵌套作用域与图注对话框。 - 模板与路由 — 可复用的布局模板、导入/导出与 frontmatter 路由。
- PDF 导出 — 纸张感知分页、版式与分页预览、页边距与页码(仅桌面端)。
本次更新内容
1.0.4
- 修复 Live Preview 中图注偏低的问题:图片行以两个空格结尾(Markdown 硬换行)时,行尾空格会在图片下方多撑出一个行盒,图注因此下移一整行。现在这些空格不再参与布局,源码内容不受影响。
- 画廊行的图注间距为 12px,单图行使用配置的图注间距(默认 6px);阅读视图行为保持不变。
- 重新生成文档断言台账:
check:docs8/8 通过,0 条错误。
Overview
AutoGallery handles image layout in Obsidian notes: consecutive images form equal-height gallery rows, single images take a ratio-based width with text wrapping, crops store only a ratio, and PDF export matches the reading view.
It never rewrites Markdown image links or writes pixel sizes; every effect comes from ag: parameters in the image caption and exportable layout profiles. Disable the plugin and the note renders natively again.
- Galleries — adjacent images form rows, with row splitting, locking, row-height ceilings and five kinds of handles.
- Single images — ratio-based width, left/right floats with text wrapping, drag to resize, alignment arrows and one-click reset.
- Captions and crops — ten
ag:parameters, ratio-based crops, nested scopes and a caption dialog. - Templates and routing — reusable layout profiles, import/export and frontmatter routes.
- PDF export — paper-aware pagination, layout and paginated previews, margins and page numbers (desktop only).
What's changed
1.0.4
- Fixed a Live Preview issue where the caption sat one blank line below the picture when an image line ended with two spaces (a Markdown hard break): those trailing spaces formed an extra line box under the block-level image. They no longer take part in layout, and the note's source is untouched.
- Gallery captions keep their 12px seam; single images use the configured caption gap (6px by default). The reading view is unchanged.
- Regenerated the documentation claim ledger:
check:docspasses 8 / 8 with 0 findings.
安装 / Install — download main.js and manifest.json below into <vault>/.obsidian/plugins/obsidian-autogallery/.
文档 / Documentation — 中文 · English · Home
示例库 / Demo vaults — 中文示例库 · English demo vault
AutoGallery 1.0.3
AutoGallery 1.0.0 — automatic image layout for Obsidian.
Core features
- Galleries — adjacent images form rows; row splitting and locking; row-height ceilings; five kinds of handles.
- Single images — ratio-based width, left/right floats with text wrapping, drag to resize, alignment arrows and one-click reset.
- Captions and crops — ten annotation parameters, ratio-based crops, nested scopes and caption dialog.
- Templates and routing — reusable layout profiles, import/export, and frontmatter routes.
- PDF export — paper-aware pagination, layout and paginated previews, margins and page numbers (desktop only).
Install
Download main.js and manifest.json from the assets below and place them in .obsidian/plugins/obsidian-autogallery/.
Documentation
Demo vaults
1.0.3 changes
- PDF export is disabled on mobile: the PDF settings section and export entries are hidden when Obsidian runs on mobile. Image layout, galleries, floats and crops remain available.
- Release assets now carry GitHub artifact attestations. Verify them with:
gh attestation verify main.js -R JH0531/obsidian-autogallery
gh attestation verify manifest.json -R JH0531/obsidian-autogalleryAutoGallery 1.0.2
AutoGallery 1.0.0 — automatic image layout for Obsidian.
Core features
- Galleries — adjacent images form rows; row splitting and locking; row-height ceilings; five kinds of handles.
- Single images — ratio-based width, left/right floats with text wrapping, drag to resize, alignment arrows and one-click reset.
- Captions and crops — ten annotation parameters, ratio-based crops, nested scopes and caption dialog.
- Templates and routing — reusable layout profiles, import/export, and frontmatter routes.
- PDF export — paper-aware pagination, layout and paginated previews, margins and page numbers.
Install
Download main.js and manifest.json from the assets below and place them in .obsidian/plugins/obsidian-autogallery/.
Documentation
Demo vaults
1.0.2 changes
Documentation and repository polish for the community review: the root README.md is now English, Chinese is README-ZH.md; the README header carries four equal-width buttons for documentation, demo vault, Ko-fi and the personal sponsor page, with the sponsor icon aligned to its label; the full GPL-3.0-or-later text and sponsor links are included. No runtime changes.
AutoGallery 1.0.1
AutoGallery 1.0.0 — automatic image layout for Obsidian.
Core features
- Galleries — adjacent images form rows; row splitting and locking; row-height ceilings; five kinds of handles.
- Single images — ratio-based width, left/right floats with text wrapping, drag to resize, alignment arrows and one-click reset.
- Captions and crops — ten annotation parameters, ratio-based crops, nested scopes and caption dialog.
- Templates and routing — reusable layout profiles, import/export, and frontmatter routes.
- PDF export — paper-aware pagination, layout and paginated previews, margins and page numbers.
Install
Download main.js and manifest.json from the assets below and place them in .obsidian/plugins/obsidian-autogallery/.
Documentation
Demo vaults
1.0.1 changes
This release fixes the plugin ID for Obsidian community plugin submission: the manifest ID is autogallery, while the project and demo vault directory keep the obsidian- prefix. Use this release for submission.
AutoGallery 1.0.0
AutoGallery 1.0.0 — automatic image layout for Obsidian.
Core features
- Galleries — adjacent images form rows; row splitting and locking; row-height ceilings; five kinds of handles.
- Single images — ratio-based width, left/right floats with text wrapping, drag to resize, alignment arrows and one-click reset.
- Captions and crops — ten annotation parameters, ratio-based crops, nested scopes and caption dialog.
- Templates and routing — reusable layout profiles, import/export, and frontmatter routes.
- PDF export — paper-aware pagination, layout and paginated previews, margins and page numbers.
Install
Download main.js and manifest.json from the assets below and place them in .obsidian/plugins/obsidian-autogallery/.
Documentation
Demo vaults