diff --git a/README.md b/README.md
index 652f447..323ce42 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,31 @@ Song pages are auto-published to <https://wiki.novoyuuparosk.org> by the
 In short: a file is published when its frontmatter has `wiki.publish: true`
 and it isn't under `wip/`. The `title` field becomes the wiki page name.
 
+## Linking to another song page
+
+Write an ordinary relative Markdown link. There is nothing to declare in the
+frontmatter:
+
+```markdown
+For more behind-the-scene shenanigans, see [Dev gibberish](pulse_dev.md).
+```
+
+At publish time the `.md` target is swapped for the target file's own `title`,
+giving a proper wikilink — so renaming a page means editing its `title` and
+nothing else. The link keeps working in Gitea's blob view and in any editor
+preview, because it is just a link.
+
+Two things to know:
+
+- The target must be published too (`wiki.publish: true`, outside `wip/`).
+  Linking to a file does **not** publish it; an unresolvable link fails the CI
+  run instead of quietly turning into plain text.
+- Links do not work inside a ` ```columns ` fence — that block is verbatim by
+  design. Put them in ordinary prose.
+
+This replaces the old `wiki.siblings` frontmatter block and its `ALL_CAPS`
+placeholders, which are gone.
+
 ## Side-by-side lyrics (columns shorthand)
 
 To lay two (or more) versions of a song next to each other — e.g. an original
diff --git a/paxprotej/fuxingdao.md b/paxprotej/fuxingdao.md
index fb0f095..03f7de2 100644
--- a/paxprotej/fuxingdao.md
+++ b/paxprotej/fuxingdao.md
@@ -5,7 +5,6 @@ categories:
   - Paxprotej
 wiki:
   publish: true
-  siblings: 
 release_date: 2023-12-25
 lrc: fuxingdao.lrc
 ---
diff --git a/paxprotej/paranoma.md b/paxprotej/paranoma.md
index b4183a8..570cee0 100644
--- a/paxprotej/paranoma.md
+++ b/paxprotej/paranoma.md
@@ -5,7 +5,6 @@ categories:
   - Paxprotej
 wiki:
   publish: true
-  siblings: 
 release_date: 2024-06-09
 lrc: paranoma.lrc
 ---
diff --git a/paxprotej/rover.md b/paxprotej/rover.md
index 864f0b3..159aa76 100644
--- a/paxprotej/rover.md
+++ b/paxprotej/rover.md
@@ -5,7 +5,6 @@ categories:
   - Paxprotej
 wiki:
   publish: true
-  siblings: 
 release_date: 2023-11-03
 lrc: rover.lrc
 ---
diff --git a/paxprotej/sauna_v2.md b/paxprotej/sauna_v2.md
index 2bad7a3..22cb9b0 100644
--- a/paxprotej/sauna_v2.md
+++ b/paxprotej/sauna_v2.md
@@ -5,7 +5,6 @@ categories:
   - Paxprotej
 wiki:
   publish: true
-  siblings: 
 release_date: 2024-06-13
 lrc: sauna_v2.lrc
 ---
diff --git a/paxprotej/shimizusawa.md b/paxprotej/shimizusawa.md
index 50946bc..5c093c4 100644
--- a/paxprotej/shimizusawa.md
+++ b/paxprotej/shimizusawa.md
@@ -5,7 +5,6 @@ categories:
   - Paxprotej
 wiki:
   publish: true
-  siblings: 
 release_date: 2023-12-09
 lrc: shimizusawa.lrc
 ---
diff --git a/ses/pulse.md b/ses/pulse.md
index 6d08cb4..6964f03 100644
--- a/ses/pulse.md
+++ b/ses/pulse.md
@@ -3,10 +3,6 @@ title: pulse under latent semantic envelopes
 album: Shirakaba Express Service
 wiki:
   publish: true
-  siblings: 
-    - path: pulse_dev.md
-      tag: PULSE_DEV
-      label: Dev gibberish
 release_date: 2026-06-18
 lrc: pulse.lrc
 ---
@@ -14,7 +10,7 @@ lrc: pulse.lrc
 # pulse under latent semantic envelopes
 
 The name of the song is stylised in all-lowercase, `pulse under latent semantic envelopes`, but Mediawiki loves a Capital letter.   
-For more behind-the-scene shenanigans, see PULSE_DEV.  
+For more behind-the-scene shenanigans, see [Dev gibberish](pulse_dev.md).  
 
 *This page is proudly the first to be maintained by Gitea actions.*  
 
diff --git a/ses/pulse_dev.md b/ses/pulse_dev.md
index b1dd5b8..237682d 100644
--- a/ses/pulse_dev.md
+++ b/ses/pulse_dev.md
@@ -4,14 +4,11 @@ categories:
   - Songwriting notes
 wiki:
   publish: true
-  siblings:
-    - path: pulse.md
-      tag: PULSE_SONG
 ---
 
 # pulse under latent semantic envelopes: personal dev notes
 
-The remaining bits of how I came to all this. For the actual song page, see PULSE_SONG.  
+The remaining bits of how I came to all this. For the actual song page, see [pulse under latent semantic envelopes](pulse.md).  
 
 ## Planning area
 
diff --git a/ses/tunnels.md b/ses/tunnels.md
index cf65905..295b2f4 100644
--- a/ses/tunnels.md
+++ b/ses/tunnels.md
@@ -3,7 +3,6 @@ title: Tunnels
 album: Shirakaba Express Service
 wiki:
   publish: true
-  siblings: 
 release_date: 2026-03-01
 lrc: tunnels.lrc
 ---