HTML 沒有單行註釋語法(如 //、#)。唯一合法註釋為 <!-- 內容 -->,單行、多行通用。
#(錨點、顏色代碼)、//(URL 協議、日期)等字元,若作為註釋符號將大量衝突,需大量轉義,反而增加複雜度。<!-- --> 雖較長,但極低衝突機率,解析器易識別邊界。<!-- 單行註釋 -->
<div>內容</div> <!-- 行尾註釋 -->
| 錯誤寫法 | 結果 | 修正 |
|---|---|---|
// 註釋 | 顯示為純文字 | <!-- 註釋 --> |
# 註釋 | 顯示為純文字 | <!-- 註釋 --> |
<! -- 註釋 --> | 解析錯誤(空格導致非標準) | <!-- 註釋 --> |
<!-- 註釋 -- --> | 提前閉合 | 移除中間 -- |
<!-- -->。c 按 Tab 展開為 <!-- -->。hc → <!-- $1 -->。<!-- 內容 -->,禁止 //、#。<!-- Header Start --> / <!-- Header End -->。<!-- TODO(author): 描述 -->,利於工具掃描。htmlhint 規則 disallow-html-comments 限制生產建構保留註釋。