HTML5注释必须用结尾，不可嵌套，禁用--和>等非法字符，可标注文字功能、标记模块起止，提升可维护性且不影响渲染。
如果您在编写HTML5代码时需要添加注释以说明特定文字或代码段的功能，则必须使用标准的HTML注释语法。以下是实现该目的的具体步骤：
一、使用标准HTML注释语法包裹说明文字
HTML5沿用HTML4及更早版本的注释语法，即以 结束，中间内容不会被浏览器解析或渲染，仅作为开发者说明存在。此方式适用于对任意位置的说明文字、标签结构或代码逻辑进行标注。
1、在需要添加注释的位置输入
4、确保注释完整闭合，且不嵌套其他注释（HTML不支持嵌套注释）
5、保存文件后，在浏览器中查看源代码可验证注释是否正确显示
二、在元素内部插入注释以说明文字内容
当需对某段可见文字（如段落、标题）添加解释性注释时，可将注释置于该元素的开始标签前、结束标签后，或嵌入标签之间（但不可破坏标签结构）。注释本身不改变页面布局或语义。
1、定位到目标文字所在元素，例如
欢迎访问我们的网站
2、在
标签前插入
3、在
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
4、确认注释未出现在浏览器渲染区域中
5、检查开发者工具的Elements面板，确认注释节点存在且位置准确
三、使用注释标记代码区段便于团队协作
在多人协作或维护复杂HTML5页面时，可用注释明确标识功能模块起止点，提升可读性与可维护性。此类注释通常成对出现，包含统一标识符。
1、在模块起始位置输入
2、编写该模块的实际HTML代码，例如 Logo
3、在模块结束位置输入
4、确保每对起止注释中的标识符完全一致（包括空格与符号）
5、避免在注释中使用双短横以外的连续破折号，以防解析异常
四、避免注释语法错误导致页面异常
HTML注释若格式错误（如缺少闭合、含非法字符），可能引发解析中断，导致后续内容无法正常渲染。必须严格遵循语法规范。
1、禁止在注释内使用 -- 字符组合（除结尾 --> 外），例如 是非法的
2、禁止在注释开头添加空格或换行，如 或换行后写 -->
3、禁止使用 的一部分
