Insert Image Plus

Insert images and Excalidraw drawings from a visual grid, grouped by filename prefix — into notes, Excalidraw, and Mappy mind maps — 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, an Excalidraw canvas or a Mappy map is active) or the ribbon ＋ icon.
• Step 1: pick a category — Recent, All, by kind (image / Excalidraw), or any detected prefix.
• Step 2: pick from a thumbnail grid (lazy-loaded, search-as-you-type). Each card shows the file type. Search matches every word: obsidian §1 finds names that contain both.
• Inserts ![[name]] (or [[name]]), with an optional default width. Into Excalidraw it places the image on the canvas.
• Excalidraw drawings are found by name (.excalidraw) or by their frontmatter (excalidraw-plugin), so renamed drawings are found too. By default only drawings whose name starts with one of your prefixes (e.g. illustration - …) are listed, so work-in-progress boards stay out of the way. The SVG next to a drawing with the same name is hidden from the picker (setting).
• Excalidraw thumbnails are rendered on the fly (on by default). Drawings heavier than 5 MB including embedded images show a placeholder instead.

Mappy support

For Mappy, the mind map plugin by Hiroya Iizuka (desktop only, like Mappy itself).

• Select a node and run Insert image: the node opens for editing and ![[name]] is added at the cursor (press Enter to confirm). If the node still has a placeholder title (Topic / Main topic / Subtopic), the title is replaced so the node shows only the image (setting).
• Mappy: Insert image inside the selected node adds the image on the line below the title and keeps the title.
• Excalidraw drawings are inserted as an SVG of that drawing only (exported next to it; up to 5 MB including embedded images).
• The categories shown in Mappy can be set separately from notes (e.g. only thumbnails and icons).
• This works on Mappy's screen (the canvas and the node editor), the same way you would type ![[ yourself. Mappy's files and logic are not touched. A Mappy update may break this until Insert Image Plus is fixed — if that happens, please report it here, not to Mappy.

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 in Markdown notes are rewritten to the new file; the original is always kept — the plugin never deletes it for you.
  • Delete — one file at a time, only when no reference is detected (checked when the dialog opens and again right before deleting). Follows Obsidian's Deleted files setting. The plugin never edits your notes to remove references.
• 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

• Get started: checks your vault and tells you what to set up first.
• General: image types (per extension), Drawings to list (None / Prefixed drawings only / All) with the drawing prefixes, hide SVGs with the same name as a drawing, drawing thumbnails, optional folder scope.
• Insert: grouped by where you insert.
  • Common: picker columns (desktop default 5, mobile default 3), how many recent items to keep.
  • Notes: category prefixes, insert format, default width.
  • Excalidraw: category prefixes, placement size per prefix.
  • Mappy: use in Mappy, category prefixes, replace placeholder titles.
• Manage: manager prefixes, reference badge on cards, WebP quality.
• Category prefixes: one box per place, one prefix per line. Empty = show every prefix found in filenames.

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

• The UI follows Obsidian's language setting (Settings → General → Language): Japanese when set to 日本語, English otherwise. Requires Obsidian 1.8.7 or later.
• Works on desktop and mobile. On mobile, the picker uses its own column count (default 3), WebP conversion is disabled on iOS, and drag & drop from the OS is not available.
• 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 をグリッドから選んで挿入するプラグインです（ノート・Excalidraw・Mappy に対応）。命名規則がそのまま UI になります。

表示言語は Obsidian の設定（設定 → 一般 → 言語）に従います。日本語なら日本語、それ以外は英語で表示します（Obsidian 1.8.7 以降）。

挿入ピッカー

• コマンド「画像を挿入する」（Markdown エディタ・Excalidraw・Mappy を開いている時だけ表示）、またはリボンの「＋」。
• カテゴリ（最近使った／すべて／種別／接頭辞）→ サムネ一覧 → クリックで ![[…]] 挿入。Excalidraw にはキャンバス上に配置。
• カードに種類（SVG／PNG／EXCALIDRAW…）を表示。絞り込みは空白区切りの全部一致（obsidian §1 で両方を含む名前）。
• Excalidraw の図は名前（.excalidraw）か frontmatter（excalidraw-plugin）で見つけるので、名前を変えた図も拾います。既定では接頭辞（illustration - … など）が付いた図だけ候補にし、作業中の図は混ざりません。図と同じ名前の隣の SVG はピッカーに出しません（設定）。サムネは既定ON、埋め込み画像込みで 5MB を超える図はプレースホルダーになります。

Mappy 対応

Hiroya Iizuka さんのマインドマッププラグイン Mappy で使えます（Mappy と同じくデスクトップのみ）。

• ノードを選んで「画像を挿入する」：ノードの編集が開き、![[…]] が入ります（確定は Enter）。題名が仮の題名（トピック／メイントピック／サブトピック）のままなら、題名を消して画像だけのノードにします（設定）。
• 「Mappy：選んだノードの中に画像を入れる」：題名を残し、題名の下の段に入れます。
• Excalidraw の図は、その図だけを SVG に書き出して入れます（図の隣に作成・埋め込み画像込みで 5MB まで）。
• Mappy で出すカテゴリは、ノートとは別に絞れます（例：サムネとアイコンだけ）。
• Mappy の画面（キャンバスとノードの編集欄）で、手で ![[ と打つのと同じように文字を入れる仕組みです。Mappy のファイルや処理には触りません。Mappy の更新で動かなくなることがあり、そのときはこちらで直します。不具合は Mappy ではなく、このリポジトリへお知らせください。

管理画面

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

参照数について

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

設定

• はじめに：Vault の状態を見て、何から設定するかを案内。
• 一般：対象にする画像（拡張子ごと）、一覧に出す図（出さない／接頭辞が付いた図だけ／全部）と図の接頭辞、図と同じ名前の SVG は出さない、図のサムネを表示、フォルダの絞り込み。
• 挿入：入れる先ごとに分けています。
  • 共通：一覧の横並び数（デスクトップ既定 5・スマホ既定 3）、「最近使った」の保持数
  • 通常（ノート）：カテゴリにする接頭辞、挿入形式、既定の幅
  • Excalidraw：カテゴリにする接頭辞、置くときの大きさ（接頭辞ごと）
  • Mappy：Mappy で使う、カテゴリにする接頭辞、仮の題名を消して入れる
• 管理：管理画面の接頭辞、カードに参照数を表示、WebP 品質。
• カテゴリにする接頭辞：入れる先ごとに 1 欄（1 行に 1 つ）。空欄＝ファイル名から見つかった接頭辞を全部出す。

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