An image-centric workflow plugin for Obsidian. Click images to enlarge with zoom, copy / download, and copy markdown selections so images paste inline into Gmail, Google Docs, Slack, etc.
- Click to enlarge — Click any image in your markdown notes to open it in a dark overlay
- Mouse wheel zoom — Scroll to zoom in/out with smart 100% snap
- Copy / Download — Copy image as PNG, save the original to disk, or copy the vault path
- Rich markdown copy — When copying selected markdown that contains image embeds (
![[...]]or), the plugin writes both plain markdown and an HTML version with images embedded as base64 data URLs, so pasting into Gmail / Google Docs / Slack shows the images inline - Smart paste-back — Pasting that rich clipboard back into Obsidian inserts the original
![[...]]markdown (no base64 bloat) - Copy as HTML with embedded images (command) — Bind a hotkey to render the selection through Obsidian's Markdown renderer (headings, lists, callouts, etc.) and write rich HTML with embedded images
- Easy dismiss — Click the background or press
Escapeto close
- Open Settings → Community plugins → Browse
- Search for Image Workflow
- Install, then enable
While the plugin is awaiting community-plugin review, install with BRAT:
- Install the BRAT plugin from Community plugins
- BRAT → "Add Beta plugin" → paste
1spread/image-workflow - Enable Image Workflow in Settings → Community plugins
- Download
main.js,styles.css, andmanifest.jsonfrom the latest release - Create a folder
image-workflowin your vault's.obsidian/plugins/directory - Copy the downloaded files into the folder
- Reload Obsidian and enable the plugin in Settings → Community plugins
| Action | Result |
|---|---|
| Click an image | Opens fullscreen overlay |
| Scroll wheel | Zoom in / out |
Cmd/Ctrl + C (overlay) |
Copy image to clipboard |
| Click "Copy" button | Copy image to clipboard |
Click "Download" button / Cmd/Ctrl + S |
Save image to disk |
Cmd/Ctrl + Shift + C (overlay) |
Copy image path to clipboard |
Click background / Escape |
Close overlay |
Select markdown with images, Cmd/Ctrl + C |
Copy as rich text with embedded images for Gmail / Docs / Slack |
| Command: Copy selection as HTML with embedded images | Full Markdown-rendered HTML + embedded images (assignable hotkey) |
- Auto-embed images on copy (default: on) — toggles the auto Cmd/Ctrl+C interception. Disable to use Obsidian's standard copy and rely solely on the Copy selection as HTML with embedded images command via your own hotkey.
- Format all markdown copies for Google apps (default: off) — when enabled, every markdown selection copied with Cmd/Ctrl+C is written as Google Docs-friendly HTML, even if it has no images.
- Preserve line breaks for Google paste (default: on) — keeps soft line breaks inside paragraphs as visible line breaks when pasting into Google Docs, Gmail, and other Google editors. Plain markdown clipboard text is unchanged.
npm install
npm run buildThe built main.js is output to the project root. Symlink the project directory into .obsidian/plugins/image-workflow/ for live development.
- Desktop only — Uses the Clipboard API (
ClipboardItem), which requires Electron - Obsidian ≥ 1.4.0
Please open an issue on GitHub with reproduction steps, your Obsidian version, and OS.