Compatibility

Obsidian 1.5 and later, desktop and mobile share one codebase. PDF export is desktop only.

Versions and platforms

Item	Support
Minimum Obsidian version	1.5
Desktop	Windows / macOS / Linux
Mobile	iOS / Android (identical except PDF export)
Live Preview	supported; gestures and handles exist only here
Reading view	supported; wrapping is judged here
Source mode	not touched

Feature availability

Feature	Desktop	Mobile	Reading view	Live Preview
Galleries	yes	yes	yes	yes
Width routing	yes	yes	yes	yes
Float and wrap	yes	yes	yes	no (space reserved only)
Crop parameters	yes	yes	yes	yes
Crop dialog	yes	yes	no	yes
Drag to resize	yes	touch	no	yes
Gallery handles	yes	touch	no	yes
PDF export	yes	no	—	—

Known limits

1. Live Preview does not wrap text. To keep the editing cursor stable the image only reserves space; text does not flow beside it. Check wrapping in reading view.
2. Callouts are not taken over. See Nested scopes.
3. Table cells only accept cropping. Width comes from the column.
4. The native PDF export only partially applies. A hidden popup has no measurable viewport, so pagination optimisation cannot run fully. Use the AutoGallery export.
5. No PDF export on mobile. It depends on desktop printing.
6. Image sizes are cached per note. A newly added image may jump for one frame on its first render, then settles.

Relationship with themes

The plugin only changes an image container's width, alignment and object-fit; it never overrides theme fonts or colours. Therefore:

• Switching themes cannot break the layout, only change type size and background.
• If your own CSS sets width: 100% on .image-embed, it may fight the plugin's percentages — a design constraint, not a bug.

Relationship with other plugins

Kind	Effect
Image management (rename, compress)	no conflict; the plugin refers to paths
Export tools (Pandoc or other PDF pipelines)	they bypass this plugin's export path, so layout may differ
Themes	see above

Next

• Pitfalls
• Troubleshooting

Related

• Install
• Settings
• Pitfalls