README file from
GithubImage Workflow
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.
Features
- 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
Installation
From Obsidian Community Plugins
- Open Settings → Community plugins → Browse
- Search for Image Workflow
- Install, then enable
Via BRAT (beta installer)
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
Manual
- 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
Usage
| 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) |
Settings
- 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.
Demo
Development
npm install
npm run build
The built main.js is output to the project root. Symlink the project directory into .obsidian/plugins/image-workflow/ for live development.
Compatibility
- Desktop only — Uses the Clipboard API (
ClipboardItem), which requires Electron - Obsidian ≥ 1.4.0
Reporting issues
Please open an issue on GitHub with reproduction steps, your Obsidian version, and OS.