テキストエディタのハイパーリンク、ファイル整理で手戻りしない！Markdownリンクを原稿へ挿入

Markdown原稿へハイパーリンクを入れるときは、表示文字だけで判断せず、リンクを書いた原稿から見た相対パスと、実際に開くファイルを一組で確かめます。章ごとにファイルを分けているなら、同じ資料へ向かうリンクでも、原稿の置き場所が変わればパスは変わります。

まず「どこから、どこへ」を決める

リンクの基本形は [表示文字](相対パス) です。たとえば、作品フォルダが次の形なら、chapters/C01.md から refs/source-note.md へ進むパスは ../refs/source-note.md になります。

manuscript/
├── chapters/
│   ├── C01.md
│   └── C02.md
└── refs/
    └── source-note.md

.. は「一つ上のフォルダへ戻る」という意味です。C01.mdから一度 manuscript へ戻り、そこから refs に入ります。C02.mdも同じ chapters フォルダにあるため、同じ相対パスを使えます。

原稿が chapters/part1/C01.md のように一段深い場所へ移れば、同じ資料へのパスは ../../refs/source-note.md です。テキストエディタのハイパーリンクで迷ったら、資料側ではなく、リンクを書く原稿ファイルを出発点にして数えてください。

3本のリンクと、直すべき1本を見分ける

小さな原稿で使ったリンクは次の形です。実際の試行では3本ともC01.mdへ挿入しました。C02.mdの例は、同じ深さならパスが変わらないことを示す計算例です。

表示文字は「こちら」よりも、リンク先の内容が分かる言葉にします。複数の出典を並べるなら、調査メモ：人物、調査メモ：年代のように、リンクを開かなくても区別できる名前が向いています。

リンク一覧を作るときは、同じ到達先をまとめるだけでなく、なぜ三つ必要なのかも確認します。たとえば本文、脚注、章末資料から同じメモへ向かう三本なら残す理由があります。ところが、同じ段落に誤って三回貼っただけなら、件数が予定どおりでも直す必要があります。検索結果では前後一行も読み、「出典を示す」「補足へ送る」「次の作業を示す」のどの役割かを一言で記録すると、重複と必要な再掲を区別しやすくなります。

また、リンク先のファイル名を変える予定があるなら、表示文字にファイル名そのものを使いすぎない方が安全です。source-note.md を 人物調査メモ と表示しておけば、後でファイル名を整理しても読者向けの文はそのまま保てます。逆に年月や版番号を案内するリンクでは、その違いが表示文字から分かるようにします。

挿入後は文字列ではなく到達先まで見る

リンクを入れたら、次の順に確認します。

1. 原稿を保存して開き直し、角括弧と丸括弧が欠けていないか読む。
2. リンクを開き、source-note.md が表示されるか確かめる。
3. 原稿内で ../refs/source-note.md を検索し、予定した本数と合うか数える。
4. ../refs/missing.md のような旧パスを別に検索し、修正対象として残す。

「新しいリンクが3本ある」ことと「古いリンクが0本である」ことは別の条件です。新しい3本が正しくても、旧パスが1本残っていればファイル整理はまだ終わっていません。

Rune Studioで扱える範囲

Rune Studioの現行Mac版について、公開されている機能説明では、txt・text・md・markdown内のMarkdown画像・リンクを扱い、ファイルやフォルダの移動・名前変更後に相対パスを書き換える機能が案内されています。今回の小さな試行では、3つの表示文字へ ../refs/source-note.md を挿入し、読み直した本文から新パス3件と意図的な旧パス1件を分けて数えられました。

ここで確かめたのはローカルファイルへの相対リンクです。外部URLがHTTPで応答するか、クラウド同期や共同編集で参照が保たれるか、ワークスペース外のファイルを追跡できるかは含みません。また、移動方法によって更新対象が異なる可能性があるため、大切な作品では複製フォルダで一度試してから本番へ反映してください。

結論：表示文字、相対パス、到達先を一組にする

Markdownリンクは、見た目の文字だけを整えても完成しません。原稿の位置から相対パスを計算し、リンクを開いて狙った資料へ着くことを確かめ、最後に旧パスを検索します。この三点を一組で扱えば、章分けやファイル整理の後も、どのリンクを直すべきか判断できます。

Rune StudioでMarkdown原稿と資料を同じ作品フォルダにまとめたい場合は、Rune Studio公式サイトで現行Mac版の案内を確認できます。