<p>HTML5添加备注须用标准注释语法<!-- -->，或data-*属性、script内JS注释、title属性四种方式，分别适用于源码标注、语义化提示、脚本说明和悬停提示。</p>
如果您在编写HTML5代码时需要添加备注或注释，以便于自己或其他开发者理解代码功能与结构，则必须使用HTML标准的注释语法。以下是几种在HTML5中添加备注的具体方法：
一、使用HTML标准注释语法
HTML5沿用HTML的注释规范，所有注释内容被包裹在<!-- 和 -->之间，浏览器会完全忽略其中的内容，既不渲染也不执行。这种注释适用于标记区块用途、临时禁用代码、说明结构逻辑等场景。
1、在需要备注的位置，输入起始符号<!--
2、紧接其后输入您的备注文字，例如：此处为导航栏开始
立即学习“前端免费学习笔记（深入）”；
3、以-->结束注释，确保前后无空格或换行干扰解析
4、可跨多行书写，但必须保证首尾符号完整闭合，如：<!--
主菜单区域
包含首页、产品、联系入口
-->
二、在标签内部嵌入data-*属性作语义化备注
HTML5支持自定义data-*属性，虽不替代传统注释，但可在元素上附加可读性强的开发提示，且保留在DOM中供JavaScript读取。该方式适合标注组件功能、版本信息或调试标识。
1、在任意HTML5标签的开始标签内添加data-note属性
2、赋值为纯文本备注，例如：data-note="轮播图容器，自动播放间隔5秒"
3、确保属性名全小写、不含空格，值用双引号包裹
4、多个备注可用连字符分隔，如data-note="type:hero-banner;status:active"
三、结合JavaScript注释对内联脚本加备注
当HTML5文档中嵌入<script>标签且使用内联JavaScript时，可在脚本内部使用JS注释语法（// 或 /* */）进行说明。这类备注仅作用于脚本逻辑，不影响HTML结构解析。
1、在<script>标签内，使用双斜杠//开头写单行备注
2、对多行逻辑说明，采用/* 开头、*/ 结尾的块级注释格式
3、关键变量或函数前添加备注，例如：// 初始化Canvas画布尺寸，适配Retina屏
4、避免在HTML注释中嵌套JS注释符号，否则可能导致HTML解析异常
四、利用HTML5的title属性提供悬停式备注
title属性是HTML5全局属性之一，其值会在用户鼠标悬停于元素上时以工具提示形式显示。它虽非源码级注释，但可作为轻量级运行时备注手段，适用于表单控件、图标按钮等功能提示。
1、在目标标签的开始标签中添加title属性
2、设置值为简明备注，例如：title="点击跳转至用户设置页（需登录）"
3、注意该属性内容会被屏幕阅读器读出，应保持语义准确、无冗余符号
4、不可用于隐藏敏感逻辑或替代源码注释，因内容可见且无保密性
