標準註釋語法
<!-- 單行註釋 -->
<!--
多行註釋
可跨越多行
-->
完整範例
<!DOCTYPE html>
<html lang="zh-Hant">
<head>
<meta charset="UTF-8">
<title>註釋示範</title>
</head>
<body>
<!-- 頁首區塊開始 -->
<header>
<h1>網站標題</h1>
<!-- 導航選單 -->
<nav><ul><li><a href="/">首頁</a></li></ul></nav>
</header>
<main>
<article>
<h2>文章標題</h2>
<p>文章內容...</p>
<!-- TODO: 加入分享按鈕 -->
</article>
</main>
<!-- 頁尾 -->
<footer>© 2024 Company</footer>
<!--[if IE]><script src="polyfill.js"></script><![endif]-->
</body>
</html>
進階應用模式
| 模式 | 用途 | 範例 |
| 區塊標記 | 標示結構邊界 | <!-- Header Start --> ... <!-- Header End --> |
| 代碼暫存 | 暫時停用功能 | <!-- <div class="beta-feature">...</div> --> |
| 待辦事項 | 團隊協作標記 | <!-- FIXME: IE11 相容性 --> |
| 建構工具指令 | Vite/Webpack/Gulp 區塊處理 | <!-- build:css assets/css/main.min.css --> |
| 模板引擎標記 | Server-side include 邊界 | <!-- #include virtual="/partials/header.html" --> |
⚠️ 重要限制
- 不可巢狀:
<!-- outer <!-- inner --> outer --> 會在 inner 結束處閉合。
- 不可出現在標籤屬性內:
<div <!-- comment --> class="x"> 非法。
- 內容不可含
--:除啟始/結束標記外,註釋文本不能出現連續兩條連字號。
- 生產環境建議移除:建構流程中用
html-minifier-terser 或 purgecss 移除,減少傳輸體積。