fix: ignore ## in code blocks for table of content

Author: paoloricciuti

packages/site-kit/src/lib/markdown/utils.ts

@@ -14,6 +14,17 @@ export const SHIKI_LANGUAGE_MAP = {
 	'': ''
 };
 
+export function is_in_code_block(body: string, index: number) {
+	const code_blocks = [...body.matchAll(/```.*\n(.|\n)+```/gm)].map((match) => {
+		return [match.index ?? 0, match[0].length + (match.index ?? 0)] as const;
+	});
+
+	return code_blocks.some(([start, end]) => {
+		if (index >= start && index <= end) return true;
+		return false;
+	});
+}
+
 /**
  * Strip styling/links etc from markdown
  */

packages/site-kit/src/lib/server/content/index.ts

@@ -1,4 +1,4 @@
-import { extract_frontmatter, slugify, smart_quotes } from '../../markdown/utils';
+import { extract_frontmatter, is_in_code_block, slugify, smart_quotes } from '../../markdown/utils';
 import type { Document } from '../../types';
 
 export async function create_index(
@@ -31,17 +31,24 @@ export async function create_index(
 				'<code>$1</code>'
 			);
 
-		const sections = Array.from(body.matchAll(/^##\s+(.*)$/gm)).map((match) => {
-			const title = smart_quotes(match[1])
-				// replace < and > inside code spans
-				.replace(/`(.+?)`/g, (_, contents) => contents.replace(/</g, '&lt;').replace(/>/g, '&gt;'))
-				// turn e.g. `class:_name_` into `class:<em>name</em>`
-				.replace(/_(.+)_/g, (_, contents) => `<em>${contents}</em>`);
-
-			const slug = slugify(title);
-
-			return { slug, title };
-		});
+		const sections = Array.from(body.matchAll(/^##\s+(.*)$/gm)).reduce(
+			(arr, match) => {
+				if (is_in_code_block(body, match.index || 0)) return arr;
+				const title = smart_quotes(match[1])
+					// replace < and > inside code spans
+					.replace(/`(.+?)`/g, (_, contents) =>
+						contents.replace(/</g, '&lt;').replace(/>/g, '&gt;')
+					)
+					// turn e.g. `class:_name_` into `class:<em>name</em>`
+					.replace(/_(.+)_/g, (_, contents) => `<em>${contents}</em>`);
+
+				const slug = slugify(title);
+
+				arr.push({ slug, title });
+				return arr;
+			},
+			[] as Array<{ slug: string; title: string }>
+		);
 
 		content[slug] = {
 			slug,