首选 Prism.js 或 Highlight.js 实现 HTML 代码高亮，前者需指定语言类名，后者支持自动识别；结合 Marked.js 可解析 Markdown 中的代码块；长期维护推荐 Docusaurus 或 VitePress 等静态站点工具，内置高亮与主题支持，提升文档专业性与可读性。
在展示 HTML 代码或编写在线技术文档时，实现代码高亮显示能显著提升可读性和专业性。以下是一些实用的方案和工具，帮助你在网页中优雅地展示 HTML 代码。
使用 Prism.js 实现代码高亮
Prism.js 是一个轻量、易于使用的开源代码高亮库，支持多种语言（包括 HTML、CSS、JavaScript 等），主题丰富，兼容性好。
使用步骤：
-
引入 Prism 的 CSS 和 JS 文件：
<link href="https://cdn.jsdelivr.net/npm/prismjs@1/themes/prism.css" rel="stylesheet" />
<script src="https://cdn.jsdelivr.net/npm/prismjs@1/prism.min.js"></script>
在页面中使用 <pre><code> 标签包裹代码，并指定语言类型：
立即学习“前端免费学习笔记（深入）”；
<pre><code class="html">
<div class="example">Hello World</div>
</code></pre>
可选：自动复制按钮、行号等插件可通过额外引入扩展增强功能。
使用 Highlight.js 替代方案
Highlight.js 是另一个流行的代码高亮库，支持自动语言检测，适合内容多样的技术文档。
优点：
-
无需手动指定语言，自动识别 HTML、JS 等语法。提供超过 180 种编程语言和 90 多个样式主题。集成简单，只需加载 CDN 资源即可生效。
示例引入方式：
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.10.0/styles/default.min.css">
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.10.0/highlight.min.js"></script>
<script>hljs.highlightAll();</script>
结合 Markdown 渲染构建文档系统
若需构建完整的在线技术文档，可采用 Markdown + 代码高亮方案，例如使用 Marked.js 解析 Markdown 内容，再交由 Prism 或 Highlight.js 高亮代码块。
-
用户以 Markdown 编写文档，代码块用 ```html 标记。前端通过 Marked 将其转为 HTML，code 元素自动带 language- 前缀类名。高亮库监听渲染完成事件，对代码块着色。
静态站点生成器推荐
对于长期维护的技术文档，建议使用静态站点工具，自带高亮支持：
-
Docusaurus（React 驱动）：内置 Prism 支持，适合开发者文档。VitePress：Vue 生态，启动快，支持自定义主题与代码块交互。Jekyll + Rouge：适用于 GitHub Pages，服务免费且部署简单。
基本上就这些。选择哪种方案取决于你的技术栈和维护成本偏好。Prism.js 简单直接，适合嵌入现有页面；而完整文档站建议用 Docusaurus 或 VitePress 提升体验。
