# Click Image to Zoom

An [Obsidian](https://obsidian.md) plugin that lets you click any image in your notes to open it in a full-size zoomable modal. Supports scroll-to-zoom, drag-to-pan, pinch-to-zoom on mobile, and keyboard controls.

Works on both desktop and mobile.

## Features

- **Click to zoom** -- click any image in a note to open it in a full-screen overlay
- **Scroll to zoom** -- use the mouse wheel to zoom in and out
- **Drag to pan** -- click and drag to move around a zoomed image
- **Pinch to zoom** -- two-finger pinch gesture on mobile/touch devices
- **Keyboard controls** -- `+`/`-` to zoom, `0` to reset, `Escape` to close
- **Per-note control** -- disable zoom for specific notes via frontmatter
- **Global toggle** -- enable/disable from settings or the command palette
- **Configurable zoom** -- adjust zoom step, minimum, and maximum zoom levels
- Works in both edit mode (live preview) and reading view

## How to Use

1. Click any image in a note -- it opens in a full-screen overlay
2. Scroll to zoom in and out
3. Click and drag the image to pan around when zoomed in
4. Click outside the image, press Escape, or click the X button to close
5. Press `0` to reset zoom and position

## Disabling for Specific Notes

Add the following frontmatter to any note where you want to disable image zoom:

```yaml
---
click-image-to-zoom: false
---
```

## Installation

### Obsidian Community Plugin

This plugin is available in the official Obsidian community plugin directory. Install it from **Settings > Community plugins > Browse** and search for "Click Image to Zoom" or "Click Image to Zoom by saltyfireball".

Community plugin page: <https://community.obsidian.md/plugins/sfb-click-image-to-zoom>

## More Plugins by saltyfireball

Browse all of my published Obsidian plugins on my profile: <https://community.obsidian.md/users/saltyfireball>

## Settings

- **Enable image zoom** -- toggle click-to-zoom on or off globally
- **Zoom step** -- how much to zoom per scroll tick or keypress (default 0.2)
- **Maximum zoom** -- maximum zoom level (default 5x)
- **Minimum zoom** -- minimum zoom level (default 0.5x)

## License

[MIT](LICENSE)