<p>HTML5注释使用<!-- -->语法,支持跨行、不渲染、不可嵌套;禁止在注释内出现"--"序列;推荐独立成行置于标签外部,避免内部嵌入或误用破折号。</p>

如果您在编写HTML5代码时需要为特定文字或代码段添加注释,以便说明用途、标注修改点或辅助团队协作,则需使用HTML标准的注释语法。以下是添加HTML5注释的具体方法:
一、使用<!-- -->包裹注释内容
HTML5沿用HTML4及XHTML的注释语法,即通过双短横线加感叹号开头、双短横线结尾的标记包裹注释文本。该语法被所有现代浏览器忽略,不会渲染到页面中,且支持跨行书写。
1、在需要插入注释的位置,输入<!--(注意:左尖括号后紧跟两个短横线和一个空格)。
2、在<!--之后输入注释文字,例如:此处为导航栏起始标记。
立即学习“前端免费学习笔记(深入)”;
3、输入-->(两个短横线后紧跟右尖括号),完成闭合。
4、完整示例:<!-- 此处为导航栏起始标记 -->。
二、在标签内部嵌入注释(不推荐但语法合法)
HTML5允许将注释写在开始标签内(位于属性之后、右尖括号之前),虽然浏览器能解析,但会降低可读性与验证兼容性,仅限临时调试使用。
1、定位到目标开始标签,如<div class="header">。
2、在class属性引号结束后、右尖括号前插入空格,再输入<!--注释-->。
3、确保注释前后无非法字符,例如:<div class="header" <!-- 顶部区域 -->>是错误写法;正确应为<div class="header" <!-- 顶部区域 -->>——但此形式实际无效;真正合法的是<div class="header"><!-- 顶部区域 -->,即注释置于标签外部。
4、严格遵循规范时,应避免在开始标签内部嵌入注释,推荐始终将注释独立成行并置于标签外部。
三、注释中嵌套HTML标签的处理方式
注释内容本身不参与HTML解析,因此其中出现的尖括号、引号等符号均被视为纯文本,无需转义。但若注释中意外包含"--"序列或以"-"结尾,可能提前终止注释,导致后续代码被误判为注释。
1、在注释中描述代码时,直接写出标签结构,例如:<!-- 使用 <section> 包裹主内容 -->。
2、避免在注释内连续使用两个短横线,如<!-- 这里不能写--这样 -->,否则注释会在第一个"--"处截断。
3、若需表达“破折号”含义,可用中文全角符号或添加空格:<!-- 这里用 —— 表示分隔 -->。
四、批量注释多行代码块
当需要临时禁用一段HTML结构(如调试时屏蔽某个<aside>区块),可将其整体用<!-- -->包裹,实现视觉与功能上的隐藏。
1、将光标置于待注释代码块的最前方,输入<!--。
2、将光标移至代码块末尾(紧贴最后一个字符后),输入-->。
3、确认注释范围准确覆盖整段结构,例如:<!-- <aside><p>侧边栏内容</p></aside> -->。
4、注意:不可嵌套注释,即注释内部不能再出现<!-- -->,否则解析器将在第一个-->处结束注释。











