diff --git a/docs/build-manual.py b/docs/build-manual.py
index 3154a20..9b5ca5b 100644
--- a/docs/build-manual.py
+++ b/docs/build-manual.py
@@ -597,7 +597,7 @@ def _split_entries(body: str) -> tuple[str, list[tuple[str, str]]]:
     return intro, entries
 
 
-ASTRO_ASIDE_COMPONENTS = {"<Aside": "Aside", "<FileTree": "FileTree"}
+ASTRO_ASIDE_COMPONENTS = {"<Aside": "Aside", "<FileTree": "FileTree", "<LinkButton": "LinkButton"}
 
 
 def _write_prettified(target: Path, fm: dict, content: str) -> None:
diff --git a/docs/fish-config.md b/docs/fish-config.md
index 952421c..a5ce4c8 100644
--- a/docs/fish-config.md
+++ b/docs/fish-config.md
@@ -39,6 +39,9 @@ A production-grade Fish shell configuration targeting Fish 4.x. It provides:
 - AI session helpers for Claude Code and Antigravity
 - Catppuccin Mocha color theme throughout
 
+<LinkButton href="/09-installation/">Install now</LinkButton>
+<LinkButton href="/reference/" variant="secondary">Function reference</LinkButton>
+
 CAUTION: **SESSION LOGGING IS ON BY DEFAULT**
 This configuration silently records terminal output to `~/.terminal_history`:
 Kitty scrollback on window close, live tmux pane streams, zellij pane
diff --git a/docs/manual/index.md b/docs/manual/index.md
index feee0d9..32c8daf 100644
--- a/docs/manual/index.md
+++ b/docs/manual/index.md
@@ -24,6 +24,9 @@ A production-grade Fish shell configuration targeting Fish 4.x. It provides:
 - AI session helpers for Claude Code and Antigravity
 - Catppuccin Mocha color theme throughout
 
+<LinkButton href="/09-installation/">Install now</LinkButton>
+<LinkButton href="/reference/" variant="secondary">Function reference</LinkButton>
+
 CAUTION: **SESSION LOGGING IS ON BY DEFAULT**
 This configuration silently records terminal output to `~/.terminal_history`:
 Kitty scrollback on window close, live tmux pane streams, zellij pane