diff --git a/kit/preprocessors/hashInCode.js b/kit/preprocessors/hashInCode.js
index 9e666725..e578769b 100644
--- a/kit/preprocessors/hashInCode.js
+++ b/kit/preprocessors/hashInCode.js
@@ -6,12 +6,17 @@ export const hashInCodePreprocess = {
 	markup: async ({ content }) => {
 		const REGEX_CODE_BLOCK = /```.*?```/gs;
 		const REGEX_INLINE_CODE = /`.*?`/g;
+		const REGEX_INLINE_EXCEPTION = /(?!.*HF_DOC_BODY_START)`.*?`(?<!HF_DOC_BODY_END.*)/gs;
 		content = await replaceAsync(content, REGEX_CODE_BLOCK, async (codeContent) => {
 			return codeContent.replaceAll("#", "&amp;num;");
 		});
 		content = await replaceAsync(content, REGEX_INLINE_CODE, async (codeContent) => {
 			return codeContent.replaceAll("#", "&amp;num;");
 		});
+		// Exception: we don't want to replace `#` in code blocks that are part of the doc body, as they may be hrefs
+		content = await replaceAsync(content, REGEX_INLINE_EXCEPTION, async (codeContent) => {
+			return codeContent.replaceAll("&amp;num;", "#");
+		});
 		return { code: content };
 	},
 };