HTML5注释必须用<!--注释内容-->语法，禁止嵌套和含--或>，支持多行，禁用条件注释，需紧邻所注代码并遵循位置规范。
如果您在编写HTML5代码时需要添加说明性文字但又不希望这些文字被浏览器解析和显示，则必须使用正确的注释语法。以下是HTML5中添加注释的具体方法与规范技巧：
一、标准HTML注释语法
HTML5沿用XML/SGML风格的注释结构，所有注释内容必须包裹在特定标记之间，且注释不能嵌套。浏览器会完全忽略该标记内的全部内容，包括换行与空格。
1、在需要注释的位置输入<!--
2、在<!--后输入任意说明文字，支持中文、英文、数字及常见符号
立即学习“前端免费学习笔记（深入）”；
3、以-->结尾，注意短横线之间不能有空格，且-->必须紧接内容末尾
4、示例：<!-- 这是一个HTML5注释 -->
二、多行注释写法
HTML5注释天然支持跨多行书写，无需额外语法，只要起始与结束标记完整，中间所有换行与缩进均被忽略。该特性常用于对大段代码块进行整体说明或临时屏蔽。
1、在代码块上方输入<!--
2、按下回车换行，输入第一行说明文字
3、继续换行并缩进书写第二行说明或待屏蔽的HTML标签
4、在最后一行末尾输入-->
5、示例：<!--
导航栏区域
<nav><ul><li>首页</li></ul></nav>
-->
三、注释中禁止使用的结构
尽管注释内容不被解析，但其边界标记本身受严格语法约束。若注释内部出现特定字符组合，可能导致解析器提前终止注释或报错，影响后续代码识别。
1、注释内不得出现连续两个短横线（--），例如“--错误示例--”
2、注释内不得出现大于号（>）单独出现在--之后，如“-->错误”
3、注释起始标记<!--之前不能有未闭合的标签或属性值
4、验证提示：任何包含--或>的注释片段都应拆分或改写为不含冲突序列的表述
四、条件注释的替代方案
HTML5已废弃IE特有的条件注释（如<!--[if IE]>），因此需采用现代兼容方式实现类似功能。可通过JavaScript检测环境后动态插入内容，或利用CSS媒体查询配合类名控制显示。
1、在<head>中添加一个空的<div id="browser-check"></div>
2、在页面底部添加script标签，执行navigator.userAgent匹配逻辑
3、根据匹配结果，为body元素添加对应浏览器标识类名，如class="chrome"
4、在CSS中使用.classname { }规则控制样式，而非依赖注释分支
5、关键提醒：HTML5中不存在合法的条件注释语法，所有[if IE]类写法均无效且可能破坏DOM结构
五、注释位置与可读性规范
注释应紧邻其所说明的代码元素，避免悬空或跨过多个无关节点。合理的位置安排能显著提升协作效率与维护速度，尤其在多人开发环境中。
1、单行元素注释置于该行上方，缩进与元素一致
2、多行结构注释置于起始标签前，且与父容器左边界对齐
3、复杂逻辑块注释首行标明作者、日期与简要目的，如“// @author:xxx @date:2024-03-15”
4、强制要求：每个<section>、<article>、<form>等语义块开头必须有描述性注释，不可省略
