Image 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 Escape to close

Installation

From Obsidian Community Plugins

1. Open Settings → Community plugins → Browse
2. Search for Image Workflow
3. Install, then enable

Via BRAT (beta installer)

While the plugin is awaiting community-plugin review, install with BRAT:

1. Install the BRAT plugin from Community plugins
2. BRAT → "Add Beta plugin" → paste 1spread/image-workflow
3. Enable Image Workflow in Settings → Community plugins

Manual

1. Download main.js, styles.css, and manifest.json from the latest release
2. Create a folder image-workflow in your vault's .obsidian/plugins/ directory
3. Copy the downloaded files into the folder
4. Reload Obsidian and enable the plugin in Settings → Community plugins

Usage

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.
• 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.

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.

License

MIT