マークダウン対応テキストエディタで画像が突然消えたように見えるとき、画像そのものではなく、原稿に書かれた相対パスが古い場所を指していることがあります。対策は、移動前に画像参照と文書リンクを分け、移動後に「旧パス0件、新パスは予定数」という条件で検索することです。
フォルダ移動は、原稿から見た距離を変える
次の作品では、三つの章が chapters、三枚の画像が images、資料が refs にあります。
book/
├── chapters/C1.md
├── chapters/C2.md
├── chapters/C3.md
├── images/I1.png
├── images/I2.png
├── images/I3.png
└── refs/source-note.md
C1.mdからI1.pngを表示する記法は  です。I1.pngを assets/I1.png へ移したら、同じ原稿からの新パスは ../assets/I1.png になります。一方、文書リンク [出典メモ](../refs/source-note.md) は資料を動かしていないので変えません。
ここで画像と文書リンクを一括置換すると、変更不要な refs まで壊すおそれがあります。先に ![]() の画像参照と []() の文書リンクを別々に数える理由はこのためです。
深い章では ../ の数が増える
別の作品で章を部ごとに分けているなら、同じ移動でも書き換えは違います。
| 原稿の場所 | 移動前の画像 | 移動後の画像 | 動かしていない資料 |
|---|---|---|---|
chapters/C1.md |
../images/I1.png |
../assets/I1.png |
../refs/source-note.md |
chapters/part2/C2.md |
../../images/I2.png |
../../assets/I2.png |
../../refs/source-note.md |
appendix/C3.md |
../images/I3.png |
../assets/I3.png |
../refs/source-note.md |
二段目と三段目は相対パスの計算例です。今回実際に動かしたのは images/I1.png から assets/I1.png への一件で、書き換え対象はC1.md内の3か所でした。計算例と、実際に得た結果を混同しないでください。
移動前後に行う検索
移動前は、旧画像 images/I1.png の利用数を確認します。予定が3件なら、原稿を一つずつ開かず、作品フォルダ全体を検索して3件を一覧にします。
移動後は次の二つを別々に検索します。
../images/I1.pngが0件である。../assets/I1.pngが3件である。
旧0件だけでは、参照が削除されただけかもしれません。新3件だけでは、旧参照が別の章に残っているかもしれません。両方がそろって初めて、三つの参照を落とさず移せたと判断できます。文書リンク2件を同時に管理する場合は、../refs/ の件数が移動前後で変わっていないことも確認します。
画像の表示確認では、検索件数に加えて一枚ずつ内容も見ます。I1.png と I2.png の名前が似ていると、パスは有効でも別の図へ着いていることがあるからです。C1の図なら、原稿の直前にあるキャプションと画像内の見出しが一致するかを照合します。差し替え前の一覧へ「C1・地図・横長」のような短い特徴を書いておくと、新パス3件がすべて開けた後の取り違え確認にも使えます。
フォルダ単位で動かす場合は、移動をさらに小さく分けます。まずI1.pngだけで旧0件・新3件を確認し、その結果が安定してから残りの画像へ進みます。一度に数十枚を動かしてから壊れた参照を探すより、どの移動で経路が変わったかを絞り込みやすくなります。原稿側の深さが複数ある作品では、とくにこの一件ずつの確認が有効です。
Rune Studioの追従修正と手動確認の境界
Rune Studioの現行Mac版は、公開されている機能説明で、原稿内のMarkdown画像・リンク記法を対象に、ファイルやフォルダの移動・名前変更後も参照が続くよう相対パスを書き換えると案内されています。
今回の試行では、I1.pngの利用が1ファイル3件ある状態を確認し、画像を images から assets へ移し、C1.mdの3か所を書き換えました。読み直した結果は旧パス0件、新パス3件でした。ただし、記録上は「移動」と「パス書き換え」が別の操作です。そのため、Finderからの移動、アプリ内の移動、フォルダ丸ごとの移動など、どの入口でも無条件に自動更新されるとは断定しません。使う移動方法を複製作品で試し、最後は旧パス検索で確かめてください。
ワークスペース外の参照、OSのエイリアス、クラウド同期、共同編集は今回の範囲外です。
結論：画像とリンクを分け、旧0件と新全件で終える
相対パス管理の要点は、フォルダ名を覚えることではなく、原稿の深さから経路を計算することです。画像だけを移したなら画像参照だけを更新し、文書リンクは維持します。最後に旧パス0件と新パス全件を確認すれば、「画像ファイルはあるのに本文で見えない」という事故を具体的に切り分けられます。
作品フォルダ内の原稿・画像・資料をまとめて扱う現行Mac版は、Rune Studio公式サイトで確認できます。