diff --git a/templates/docs.templ b/templates/docs.templ
index a3360a71..64c7bd92 100644
--- a/templates/docs.templ
+++ b/templates/docs.templ
@@ -23,7 +23,7 @@ templ DocsLayout(nav Navigation, doc Document, user User, currentPath string) {
 			<link href="/static/style.css" rel="stylesheet"/>
 			<link rel="icon" type="image/svg+xml" href="/static/favicon.svg"/>
 		</head>
-		<body x-data="docs" x-init="initializeSearch(); initializeCodeCopyButtons()" class={ "theme-" + user.Theme + " page-docs font-sans antialiased" }>
+		<body x-data="docs" x-init="scrollSidebarToActive(); initializeSearch(); initializeCodeCopyButtons()" class={ "theme-" + user.Theme + " page-docs font-sans antialiased" }>
 			@DocsTopbar(user)
 			<!-- Mobile drawer backdrop -->
 			<div id="docs-overlay" class="hidden fixed inset-0 z-40 lg:hidden" style="background: var(--surface-overlay);" onclick="document.getElementById('docs-sidebar').classList.add('-translate-x-full'); this.classList.add('hidden')"></div>
diff --git a/templates/docs_templ.go b/templates/docs_templ.go
index b3fbef86..062da2b3 100644
--- a/templates/docs_templ.go
+++ b/templates/docs_templ.go
@@ -71,7 +71,7 @@ func DocsLayout(nav Navigation, doc Document, user User, currentPath string) tem
 		if templ_7745c5c3_Err != nil {
 			return templ_7745c5c3_Err
 		}
-		templ_7745c5c3_Err = templruntime.WriteString(templ_7745c5c3_Buffer, 4, "<body x-data=\"docs\" x-init=\"initializeSearch(); initializeCodeCopyButtons()\" class=\"")
+		templ_7745c5c3_Err = templruntime.WriteString(templ_7745c5c3_Buffer, 4, "<body x-data=\"docs\" x-init=\"scrollSidebarToActive(); initializeSearch(); initializeCodeCopyButtons()\" class=\"")
 		if templ_7745c5c3_Err != nil {
 			return templ_7745c5c3_Err
 		}
diff --git a/web/src/docs.ts b/web/src/docs.ts
index 328185e1..5eb65a8d 100644
--- a/web/src/docs.ts
+++ b/web/src/docs.ts
@@ -37,6 +37,33 @@ function toggleCollapsible(header: HTMLElement): void {
   applyCollapsed(items, !isCollapsed);
 }
 
+// scrollSidebarToActive brings the current page's (bold) nav link into the
+// sidebar's visible area on load — deep links from search, bookmarks, or
+// the overview page otherwise open with the highlight scrolled out of
+// sight. Only the sidebar's own scroll position changes, never the page.
+function scrollSidebarToActive(): void {
+  const sidebar = document.getElementById("docs-sidebar");
+  if (!sidebar) return;
+
+  // Skip the off-canvas mobile drawer (translated off screen).
+  if (sidebar.classList.contains("-translate-x-full")) return;
+
+  const active = sidebar.querySelector<HTMLAnchorElement>(
+    `a[href="${location.pathname}"], a[href="${location.pathname.replace(/\.md$/, "")}"]`,
+  );
+  if (!active) return;
+
+  const sb = sidebar.getBoundingClientRect();
+  const ar = active.getBoundingClientRect();
+  if (ar.top >= sb.top && ar.bottom <= sb.bottom) return; // already visible
+
+  if (ar.top < sb.top) {
+    sidebar.scrollTop += ar.top - sb.top;
+  } else {
+    sidebar.scrollTop += ar.bottom - sb.bottom;
+  }
+}
+
 let docsSearchTimeout: ReturnType<typeof setTimeout> | null = null;
 let docsSearchAbort: AbortController | null = null;
 
@@ -126,4 +153,5 @@ Alpine.data("docs", () => ({
   toggleCollapsible,
   initializeSearch: initializeDocsSearch,
   initializeCodeCopyButtons,
+  scrollSidebarToActive,
 }));