Insert Image Plus

Insert images and Excalidraw drawings from a visual grid, grouped by filename prefix — and manage them one file at a time.

If you name your assets like icon - map.png, logo - shopify.svg, stick - idea.png, the part before - becomes a category. No folders to maintain, no tags to add: the naming convention is the UI.

日本語の説明は 下にあります.

Features

Insert picker

• Command Insert image (only shown when a Markdown editor or an Excalidraw canvas is active) or the ribbon ＋ icon.
• Step 1: pick a category — Recent, All, by kind (image / Excalidraw / note), or any detected prefix.
• Step 2: pick from a thumbnail grid (lazy-loaded, search-as-you-type).
• Inserts ![[name]] (or [[name]]), with an optional default width. Into Excalidraw it places the image on the canvas.
• Excalidraw files can be shown as live thumbnails (optional).

Manager view

• Command Manage images or the ribbon gallery icon opens a tab.
• Filter by folder and by prefix chips; search; sort by name / created / modified / size / references.
• Each card shows the number of detected references, the file type, size and date. Hover for quick actions.
• Click a card for details: large preview, referencing notes (click to jump to the line), and actions:
  • Open in Obsidian · Open with default app · Show in system explorer · Copy link
  • Rename with a prefix picker (keeps the prefix - name convention)
  • Move to another folder
  • Convert to WebP (PNG / JPG / BMP / AVIF; references are rewritten; original goes to trash)
  • Delete — one file at a time, to trash. Blocked while references exist; Delete with references removes the links/embeds from Markdown notes first.
• Drag & drop image files from your OS onto the view to add them; you choose the prefix on drop.

Honest about references

Reference counts come from Obsidian's link index ([[ ]], ![[ ]], []() in Markdown). References inside Canvas files, plain-string frontmatter values, code blocks or CSS snippets are not detected — so the UI says "detected references", never "unused". There is deliberately no bulk delete.

Settings

• Which kinds to include (images / Excalidraw / notes), optional folder scope.
• Insert format and default width.
• Prefix mode, separately for the picker and the manager: auto (collect from filenames), only listed prefixes, or off.
• Reference badge on cards; WebP quality.

Rename and Move require Obsidian's Files & Links → Automatically update internal links to be on; otherwise the buttons are disabled to avoid breaking links.

Install (manual, until listed)

1. Create <vault>/.obsidian/plugins/insert-image-plus/.
2. Copy main.js, manifest.json, styles.css from the latest release into it.
3. Reload Obsidian and enable Insert Image Plus under Community plugins.

Notes

• WebP conversion uses the Canvas API and is available wherever the rendering engine can encode WebP (Chromium-based desktop and Android). On iOS the button is disabled.
• "Open with default app" and "Show in system explorer" use desktop-only capabilities and are skipped gracefully elsewhere.

License

MIT © 2026 Yosuke

日本語

ファイル名の接頭辞（icon - 地図.png の icon）を自動でカテゴリにして、画像と Excalidraw をグリッドから選んで挿入するプラグインです。命名規則がそのまま UI になります。

挿入ピッカー

• コマンド「画像を挿入する」（Markdown エディタか Excalidraw を開いている時だけ表示）、またはリボンの「＋」。
• カテゴリ（最近使った／すべて／種別／接頭辞）→ サムネ一覧 → クリックで ![[…]] 挿入。Excalidraw にはキャンバス上に配置。

管理画面

• コマンド「画像を管理する」またはリボンのギャラリーアイコンでタブが開きます。
• フォルダ × 接頭辞チップ × 検索で絞り、名前／作成日／更新日／サイズ／参照数で並び替え。
• カードに「検出できた参照 N」・種別・サイズ・日付。ホバーで開く／コピー／リネーム／削除。
• クリックで詳細：大きなプレビュー、参照しているノート（クリックで該当行へ）、操作（Obsidian で開く／OS 標準アプリで開く／ファイルの場所／リンクをコピー／リネーム／移動／WebP に変換／削除）。
• 削除は 1 枚ずつ・ゴミ箱へ。参照がある間は削除できず、「参照も消して削除」で Markdown 内のリンク・埋め込みを消してから削除します。一括削除は持ちません。
• OS から画像ファイルをドラッグ＆ドロップすると追加できます（その場で接頭辞を選択）。

参照数について

Obsidian のリンク索引（Markdown 内の [[ ]] ![[ ]] []()）を逆引きしています。Canvas・frontmatter の素の文字列・コードブロック・CSS スニペット内の参照は検出できないため、「未参照」ではなく「検出できた参照」と表示します。

設定

• 対象種別（画像／Excalidraw／ノート）、フォルダの絞り込み。
• 挿入形式と既定の幅。
• 接頭辞の出し方（自動／指定のみ／OFF）を、挿入ピッカーと管理画面で別々に設定。
• 参照バッジの表示、WebP 品質。

リネームと移動は、Obsidian 設定「ファイルとリンク → 内部リンクを自動更新」が ON の時だけ使えます（OFF だとリンクが切れるため、ボタンが無効になります）。