README file from
GithubImage Hoist for Obsidian

Stop worrying about heavy notes and broken images.
Image Hoist is the ultimate tool to keep your Obsidian vault light, fast, and 100% shareable. It automatically takes your local images, moves them to the cloud (ImgBB), and replaces them with links that work anywhere.
🌟 Why you need Image Hoist
- Save Massive Space: Stop hoarding gigabytes of images in your vault. Keep your storage for what matters: your ideas.
- Lightning-Fast Sync: Since your images are in the cloud, syncing your notes across devices (mobile, tablet, desktop) becomes instant.
- Share Without Friction: When you copy-paste a note to a blog, email, or another person, your images will actually show up! No more broken links.
- Zero Effort: Paste an image and forget about it. The plugin handles the upload and link replacement in the background.
🚀 Key Benefits
- Set and Forget: Enable "Auto-hoist" and every image you paste goes straight to the cloud. No local files, no clutter.
- Smart Uploads: Already uploaded the same image? The plugin is smart enough to recognize it and reuse the existing link instantly.
- Note Cleanup: Got an old note full of local images? One click and the whole note is "hoisted" to the cloud.
- Safe & Secure: Your images are yours. Your access keys are kept private and secure within Obsidian.
🛠️ Quick Start
- Install: Add the plugin to your Obsidian vault.
- Connect: Get a free key from ImgBB and paste it into the plugin settings.
- Enjoy: Start pasting images or right-click any existing image to "hoist" it.
📖 How to use it
- Drag & Drop: Just drag an image into your note—it goes straight to the cloud (if enabled).
- Right-Click: See a local image? Right-click and select Hoist this image.
- The Magic Button: Use the Command Palette (
Cmd/Ctrl + P) and run Hoist all images in current note to clean up an entire page at once.
📄 License
This project is licensed under the MIT License.