需将HTML特殊字符转义为实体以实现代码原样显示，常用方法包括：手动实体替换、pre/code标签配合转义、JavaScript动态转义、CSS white-space控制、highlight.js语法高亮。
如果您希望在网页中直接显示HTML代码本身，而不是让浏览器解析并渲染这些代码，则需要将HTML特殊字符转换为对应的HTML实体。以下是实现此效果的多种方法：
一、使用HTML实体转义
该方法通过手动将尖括号、引号等字符替换为HTML实体，使浏览器将其视为纯文本而非标记语言进行解析。
1、将 替换为 <。
2、将 > 替换为 >。
立即学习“前端免费学习笔记（深入）”；
3、将 " 替换为 "。
4、将 & 替换为 &。
5、在页面中使用 <code></code>
标签包裹转义后的内容，以保留格式和空格。
二、使用 和 <code> 标签配合转义</code>
该方法结合语义化标签与实体转义，在保持代码可读性的同时确保安全显示。
1、在HTML文档中插入 <code></code>
元素对。
2、在 内部输入已转义的HTML内容，例如：<div>Hello</div>。
3、确保所有嵌套层级中的特殊字符均已完成转义，避免提前闭合标签。
三、使用JavaScript动态转义并插入
该方法利用脚本自动处理原始HTML字符串，适用于需频繁更新或从外部加载代码片段的场景。
1、定义包含原始HTML的字符串变量，如 const rawHtml = " Test 分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
2、创建一个临时DOM元素，例如 const temp = document.createElement("div");。
3、将原始字符串赋值给该元素的 textContent 属性：temp.textContent = rawHtml;。
4、读取该元素的 innerHTML 属性，此时内容已自动转义：const escaped = temp.innerHTML;。
5、将 escaped 插入目标容器的 innerHTML 中，并用 <code></code>
包裹。
四、使用CSS white-space属性控制显示
该方法不改变HTML内容本身，而是通过样式控制浏览器如何呈现预格式化文本，常与转义配合使用。
1、为用于展示代码的容器添加 style="white-space: pre-wrap;"。
2、确保该容器内文本已做基本实体转义，防止标签被解析。
3、可选地添加 font-family: monospace; 以增强代码可读性。
4、设置 overflow-x: auto; 防止长行溢出容器边界。
五、使用第三方库如highlight.js进行语法高亮展示
该方法适用于需要专业级代码展示效果（如颜色区分标签、属性、文本）的场景，前提是已引入对应JS和CSS资源。
1、在页面中引入highlight.js的CDN链接，包括CSS样式与JS脚本。
2、准备一段已转义的HTML字符串，例如存于 <code class="html"></code>
内部。
3、确保字符串中所有 、>、& 均已被替换为对应实体，否则会破坏结构。
4、调用 hljs.highlightAll(); 启用自动高亮功能。
