HTML注释语法为，所有浏览器均支持；不可嵌套，不参与解析与渲染，不能用于/内，位置须在文档合法区域，对性能和SEO无实质影响。
HTML 注释怎么写：最简语法就是 <!-- 内容 -->
所有浏览器都支持这个写法，没有例外。注释内容不会被解析、不参与渲染、不发送到服务器，纯粹给开发者看的“便签”。
常见错误现象：/* */ 或 // 在 HTML 文件里当注释用 —— 这是 CSS/JS 的语法，HTML 解析器直接忽略，甚至可能破坏结构（比如误吞掉后续标签）。
- 不能嵌套：
<!-- <!-- 嵌套会出错 --> -->会导致从第一个<!--开始，直到最后一个-->才结束，中间所有 HTML 都被当成注释 - 不能出现在
<script></script>或<style></style>标签内部（除非你真想注释掉整段 JS/CSS）—— 这些标签里的内容由对应语言引擎处理，应使用//或/* */ - 注释里可以写任意文本，包括 HTML 标签，但它们不会被解析：
<!-- <div>这不会变成 div</div> -->
HTML 注释能放哪儿：位置比内容更重要
可以放在文档任意位置，只要不在标签内部（如 <div title="<!-- 错！-->">）、不在 DOCTYPE 前、不在 XML 声明后（如果用了）。<p>典型安全位置：</p>
<p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记（深入）</a>”；</p>
<ul>
<li>文档开头说明作者和更新时间：<code><!-- Author: Zhang San, Updated: 2024-06-15 -->
<!-- Header section start --><header>...</header><!-- Header section end -->
<!-- <nav><ul>...</ul></nav> -->
容易踩的坑：在 里注释掉 <meta charset="utf-8"> 后没注意编码声明缺失，导致中文乱码 —— 注释不是删除，它只是“看不见”，但页面依然按原逻辑加载。
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
HTML 注释对性能和 SEO 有影响吗
没有实质影响。现代浏览器解析时直接跳过注释，不占用 DOM 节点，也不影响渲染流水线。
但要注意两点：
- 体积：大量冗余注释（比如每行都加
<!-- TODO: xxx -->）会增大 HTML 文件大小，拖慢首屏加载，尤其在弱网下 - SEO：搜索引擎不读注释，也不会因注释内容惩罚或奖励页面；但如果你把关键词堆在注释里试图“作弊”，纯属浪费时间
上线前建议删掉无意义的开发期注释，保留关键结构说明即可。
VS Code / WebStorm 里怎么快速加 HTML 注释
编辑器支持快捷键自动包裹选中内容，但默认行为依赖语言模式识别。
- 确保文件后缀是
.html或当前编辑器语言模式设为HTML（右下角状态栏检查） - 选中文本，按
Ctrl+/（Windows/Linux）或Cmd+/（macOS）—— 多数主流编辑器会自动插入<!-- ... --> - 如果快捷键插出来的是
//，说明编辑器误判为 JS 或 CSS，手动切回 HTML 模式再试
别依赖模板片段写 <!-- $1 --> 这种，手快易漏掉 -->，浏览器不会报错，但注释会一路吃到文件末尾。
