Obsidian Plugin Image Upload Toolkit: came to 1.0

The Problem with Images in Markdown Notes

As an avid Obsidian user and note-taker, I’ve always struggled with one persistent challenge: managing images in my markdown files, especially when publishing or sharing them outside of Obsidian. While Obsidian handles local images beautifully within your vault, the moment you want to share your content on platforms like GitHub Pages, WordPress, or Medium, those local image references break.

After facing this problem repeatedly, I decided to create a solution: the Obsidian Image Upload Toolkit.

Introducing the Obsidian Image Upload Toolkit 1.0

I’m excited to announce the official 1.0 release of the Obsidian Image Upload Toolkit — a plugin designed to bridge the gap between your local Obsidian notes and the platforms where you share your content.

The concept is simple but powerful:

• You continue writing in Obsidian with local images as you normally would
• When ready to publish, a single command uploads all images to your preferred cloud provider
• The plugin copies the updated markdown with cloud image links to your clipboard
• Your original notes remain unchanged in your vault

Key Features That Make a Difference

1. Multiple Cloud Storage Options

The plugin supports an impressive eight different cloud storage providers:

• Imgur — Perfect for quick, free image hosting
• GitHub Repository — Ideal for bloggers using GitHub Pages
• Amazon S3 — Enterprise-grade scalable storage
• Cloudflare R2 — Modern S3-compatible storage at lower costs
• AliYun OSS — Great option for users in Asia
• TencentCloud COS — Another solid option for the Chinese market
• Qiniu Kodo — Popular object storage service
• Imagekit — Optimized image CDN for better performance

This flexibility means you can choose the provider that best fits your workflow, geographic needs, and budget constraints.

2. One-Click Workflow

With a single command (“publish page” from the command palette), the plugin:

1. Identifies all local images in your current note
2. Uploads them to your configured cloud provider
3. Replaces the local image paths with cloud URLs in the copied version
4. Places the ready-to-publish markdown on your clipboard
5. Notifies you when the process is complete

3. Preservation of Your Original Content

By default, your original notes remain untouched, preserving your local references. This is crucial for maintaining the integrity of your knowledge base while still enabling easy publishing.

However, if you prefer to update the original files directly, there’s an option for that too.

4. Customizable Paths and Organization

The plugin allows you to configure how your images are organized in your cloud storage with custom path templates, helping you maintain a clean and structured media library.

How to Get Started

Installing and configuring the plugin is straightforward:

1. Open Obsidian and go to Settings > Community plugins
2. Browse for “Image Upload Toolkit” and install
3. Configure your preferred image store in the plugin settings
4. Start publishing your notes with cloud-hosted images!

Use Cases That Benefit Most

This plugin is particularly valuable for:

• Bloggers who draft in Obsidian but publish elsewhere
• Technical writers creating documentation with many screenshots
• Students sharing notes with classmates
• Researchers publishing findings with data visualizations
• Knowledge workers who maintain both private notes and public content

Comprehensive Configuration Options

The plugin provides detailed setup guides for each supported platform, making it easy to configure even if you’re not technically inclined. Each image store has specific configuration requirements that are clearly documented in the plugin settings.

Conclusion

The Obsidian Image Upload Toolkit represents hundreds of hours of development aimed at solving a common pain point for Obsidian users who share their content outside their vault. By bridging the gap between local note-taking and cloud publishing, it eliminates one of the most frustrating friction points in the markdown workflow.

If you’ve ever struggled with managing images when sharing your Obsidian content, I invite you to try the plugin and experience a more seamless publishing workflow.