<p>HTML5中注释说明文字应使用<!-- -->语法，script/style内用对应语言注释，面向用户的说明须用aria属性或语义化标签。</p>
如果您在编写HTML5代码时需要为说明文字添加注释，以提高代码可读性或临时禁用某段标记内容，则需使用标准的HTML注释语法。以下是实现该目的的具体方法：
一、使用<!-- -->包裹说明文字
HTML5沿用HTML4以来的注释语法，通过<!-- 和 -->成对包裹任意文本，浏览器会完全忽略其中所有内容，既不渲染也不执行。这是唯一被所有浏览器支持且符合HTML5规范的注释方式。
1、在需要注释的说明文字前输入<!--（注意短横线后无空格）。
2、在说明文字末尾紧接输入-->（注意短横线前无空格，且“>”为单个字符）。
立即学习“前端免费学习笔记（深入）”；
3、确保注释内容不嵌套，即不能在<!-- 内部再次出现<!--。
4、可在注释中包含HTML标签、属性、文字甚至空行，但均不会被解析：<!-- 这是一段说明文字，包含 <p>标签也不会被渲染 -->。
二、在script或style标签内部使用语言原生注释
当说明文字位于<script>或<style>标签内时，应优先采用JavaScript或CSS各自的注释语法，避免混用HTML注释，防止解析异常或语义混淆。
1、在<script>标签内，使用//单行注释或/* */多行注释：// 此处说明JS逻辑用途。
2、在<style>标签内，统一使用/* */包围说明文字：/* 此CSS规则用于控制标题字体大小 */。
3、禁止在<script>或<style>标签内使用<!-- -->注释HTML式说明，因现代HTML5解析器虽兼容但易引发维护歧义。
三、避免使用HTML注释替代可访问性属性
若说明文字实际用于辅助技术（如屏幕阅读器）理解内容，不应依赖注释，而应使用aria-label、aria-describedby等WAI-ARIA属性或<figure><figcaption>等语义化结构。
1、将说明性文字作为<figcaption>子元素置于<figure>内：<figure><img src="demo.jpg"><figcaption>此处为图像说明文字</figcaption></figure>。
2、为交互元素添加aria-label属性：<button aria-label="关闭弹窗">×</button>。
3、确认所写内容是否真为开发者备注——若是面向用户的信息，则绝不可放入<!-- -->中，因其对终端用户完全不可见。
