HTML5仅支持单种注释,天然跨行但无自动缩进、不解析格式、不支持嵌套;换行符在源码中保留但浏览器忽略,影响可读性而不影响渲染。

HTML5 本身不支持原生多行注释语法, 是唯一合法的注释容器,它天然支持跨行,但换行和排版全靠手动控制——没有自动缩进、不解析内部格式、不支持嵌套。
HTML 注释的换行行为:为什么回车会生效
之间的所有内容(包括换行符、空格、制表符)都会被浏览器完全忽略,但源码中保留原样。这意味着你按 Enter 换行,HTML 文件里就真多了换行符,对渲染无影响,但会影响可读性与协作体验。
- 换行是“可见的”,但对浏览器不可见——调试时用“查看页面源代码”能看到整齐排版,用“元素检查器”则完全看不到注释
- 不能在注释内写
,否则会提前截断,导致后续内容意外暴露为 HTML - 某些构建工具(如 Webpack + html-webpack-plugin)或模板引擎(如 EJS、Pug)可能预处理注释,需确认是否保留原始换行
长文本注释的排版惯例:对齐、缩进与分隔线
没有标准强制要求,但团队协作中普遍采用类代码注释风格:首行顶格写 ,关键段落用空行或 --- 分隔。
- 避免用 Tab 缩进(不同编辑器显示宽度不一致),统一用空格
- 不要在注释开头加空行,否则
很容易误伤或误导。立即学习“前端免费学习笔记(深入)”;
- 禁用代码块:用
可能因引号或嵌套-->导致截断;更安全的做法是外层套一层
- 禁用代码块:用











