HTML5仅支持单种注释，天然跨行但无自动缩进、不解析格式、不支持嵌套；换行符在源码中保留但浏览器忽略，影响可读性而不影响渲染。
HTML5 本身不支持原生多行注释语法，<!-- --> 是唯一合法的注释容器，它天然支持跨行，但换行和排版全靠手动控制——没有自动缩进、不解析内部格式、不支持嵌套。
HTML 注释的换行行为：为什么回车会生效
<!-- 和 --> 之间的所有内容（包括换行符、空格、制表符）都会被浏览器完全忽略，但源码中保留原样。这意味着你按 Enter 换行，HTML 文件里就真多了换行符，对渲染无影响，但会影响可读性与协作体验。
- 换行是“可见的”，但对浏览器不可见——调试时用“查看页面源代码”能看到整齐排版，用“元素检查器”则完全看不到注释
- 不能在注释内写
<!--或-->，否则会提前截断，导致后续内容意外暴露为 HTML - 某些构建工具（如 Webpack + html-webpack-plugin）或模板引擎（如 EJS、Pug）可能预处理注释，需确认是否保留原始换行
长文本注释的排版惯例：对齐、缩进与分隔线
没有标准强制要求，但团队协作中普遍采用类代码注释风格：首行顶格写 <!--，内容缩进 2–4 个空格，末行顶格写 -->，关键段落用空行或 --- 分隔。
Investment Researcher Digital Employee
下载
覆盖宏观策略、固收研究、行业公司深度分析、量化因子、大类资产配置、可转债、市场情绪、政策快评、行业景气度追踪等34项核心研究能力，证券研究员的全能数字助手。
<!-- 页面顶部导航栏区域 - 包含 logo、主菜单、用户登录状态 - 响应式断点：768px 下折叠为汉堡菜单 - 注意：SSR 渲染时需同步服务端 active 状态 -->
- 避免用 Tab 缩进（不同编辑器显示宽度不一致），统一用空格
- 不要在注释开头加空行，否则
<!--上方会多出空白行，破坏结构紧凑性 - 超过 5 行的说明建议每行控制在 80 字符以内，方便 Git diff 和移动端查看
哪些情况不该用 HTML 多行注释
当注释目的不是解释 HTML 结构本身，而是临时禁用大段代码、标记待办、或描述 JS/CSS 逻辑时，<!-- --> 很容易误伤或误导。
立即学习“前端免费学习笔记（深入）”；
- 禁用代码块：用
<!-- <div class="legacy-banner">...</div> -->可能因引号或嵌套-->导致截断；更安全的做法是外层套一层<div style="display:none"> 或直接删掉<li>TODO / FIXME：这类标记不会被任何 HTML 工具识别，建议改用 JS 注释（如 <code>// TODO: 迁移至 Header 组件）并放在对应<script></script>块中 - 敏感信息说明（如“此处调用内部 API”）：若 HTML 被公开，注释也会暴露，应移至文档或内部 Wiki
真正需要多行注释的地方其实不多——多数时候，一个清晰的 class 名（如 js-cart-summary）比十行注释更可靠。如果发现自己频繁依赖长注释来解释 HTML，可能该重构结构，而不是优化注释格式。
