kit/preprocessors/hashInCode.js

import { replaceAsync } from "./utils.js";

// Preprocessor that converts `#` char inside code/codeblocks into its html5 entity `#`
// otherwise, an extra new space was being rendered
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 };
	},
};