From d1502533e3219601d00a9c47b4ac505b9dfe5011 Mon Sep 17 00:00:00 2001
From: limes <git@limes.pink>
Date: Mon, 31 Aug 2026 23:49:05 +0200
Subject: [PATCH] fix(#460): #fragment links not working

---
 src/pages/docs/[...slug].vue | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/src/pages/docs/[...slug].vue b/src/pages/docs/[...slug].vue
index c54de8e..6472f92 100644
--- a/src/pages/docs/[...slug].vue
+++ b/src/pages/docs/[...slug].vue
@@ -1,5 +1,7 @@
 <script setup lang="ts">
-const slug = (useRoute().params.slug as string[]).join('/');
+const { path, params } = useRoute();
+const slug = (params.slug as string[]).join('/');
+
 const { data: doc } = await useAsyncData(`docs-${slug}`, () => {
 	return queryCollection('docs').path(`/docs/${slug}`).first();
 });
@@ -7,6 +9,25 @@ const { data: doc } = await useAsyncData(`docs-${slug}`, () => {
 if (!doc.value) {
 	throw createError({ statusCode: 404, statusMessage: 'Page Not Found' });
 }
+
+function fixFragmentLinks(e: MouseEvent) {
+	const targetEl = e.target as HTMLAnchorElement;
+	const to = targetEl?.getAttribute('href');
+
+	if (targetEl?.tagName !== 'A' || !to?.startsWith('#')) {
+		return;
+	}
+
+	// nuxt content just drops dashes at the start of the fragment, so we do the same
+	const sanitizedTo = to.replace(/^#-*/, '');
+
+	// a fragment cannot start with a number, so nuxt content prefixes it with an underscore.
+	const newPath = /^[0-9]/.test(sanitizedTo) ? `${path}#_${sanitizedTo}` : `${path}#${sanitizedTo}`;
+
+	e.preventDefault();
+	return navigateTo(newPath, { external: true });
+}
+
 customSeoMeta({
 	subsection: 'docs',
 	title: doc.value.title,
@@ -23,6 +44,7 @@ definePageMeta({
     <ContentRenderer
       v-if="doc"
       :value="doc"
+      @click="fixFragmentLinks"
     />
   </div>
 </template>