diff --git a/.changeset/fix-toc-nested-comments.md b/.changeset/fix-toc-nested-comments.md
new file mode 100644
index 00000000..0b636131
--- /dev/null
+++ b/.changeset/fix-toc-nested-comments.md
@@ -0,0 +1,5 @@
+---
+"@ainsleydev/sveltekit-helper": patch
+---
+
+Fix `TableOfContents` component erroring at runtime due to nested HTML comments in the `@component` doc block closing the outer comment early, causing Svelte to parse example markup as real template code.
diff --git a/packages/sveltekit-helper/src/components/TableOfContents.svelte b/packages/sveltekit-helper/src/components/TableOfContents.svelte
index 6e66d179..9b352a24 100644
--- a/packages/sveltekit-helper/src/components/TableOfContents.svelte
+++ b/packages/sveltekit-helper/src/components/TableOfContents.svelte
@@ -114,16 +114,12 @@ export type TableOfContentsProps = {
 
 	@example
 	```svelte
-	<!-- Attach data attributes to the content element -->
 	<RichText content={data.body} data-sidebar-content="true" data-sidebar-selector="h3" />
-
-	<!-- TOC auto-discovers headings -->
 	<TableOfContents heading="On this page" />
 	```
 
 	@example
 	```svelte
-	<!-- Explicit prop overrides -->
 	<TableOfContents
 		contentSelector=".article-body"
 		headingSelector="h2, h3"
@@ -134,7 +130,6 @@ export type TableOfContentsProps = {
 
 	@example
 	```svelte
-	<!-- Manual items (scrollspy still driven by DOM) -->
 	<TableOfContents items={[{ label: 'Intro', href: 'intro' }]} />
 	```
 -->