将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
hgroup 标签在 html5.2 中已被 w3c 和 whatwg 正式移除,不再具有语义功能,不影响大纲、不触发 aria 行为,主流浏览器仅解析而不赋予含义,应彻底弃用并改用语义化替代方案。

hgroup 标签在现代 HTML 中已无规范地位,不该再用。
HTML5.2 起 hgroup 已被正式移除
W3C 和 WHATWG 在 HTML5.2 规范中彻底删除了 hgroup,它不再属于合法 HTML 元素。所有主流浏览器(Chrome、Firefox、Safari、Edge)虽能解析该标签而不报错,但:
- 不赋予任何语义含义
- 不影响文档大纲(h1–h6 层级照常计算)
- 不触发特殊 ARIA 行为
- 构建工具(如 html-validate、Astro lint 插件)默认警告或报错
- TypeScript + JSX 项目需额外声明类型,否则编译失败
为什么你写的 hgroup 看似“能用”,其实完全失效
常见错误现象包括:
- 写了 <hgroup><h1>A</h1>
<h2>B</h2></hgroup>,但 Lighthouse 或 axe 仍把 B 当作独立二级标题计入大纲
- 旧版 JAWS(如 14)曾尝试支持,但行为不一致;当前所有主流屏幕阅读器完全忽略 hgroup - 开发者误以为它能“合并”标题语义,结果反而让辅助技术更难理解结构
- CSS 选择器如 hgroup > h1 + h2 脆弱且无实际语义价值
替代方案要按真实需求选,不是套模板
根据你要解决的具体问题选:
- 只需视觉分层(主标题大、副标题小灰)→ 用 <h1></h1> + <p class="subtitle"></p>,纯 CSS 控制样式
- 需隐藏副标题对辅助技术的影响 → 给 <p></p> 加 aria-hidden="true" - 副标题本身有语义价值(如文章导语、发布日期)→ 直接用 <h2></h2> 或 <header></header> 包裹,接受它出现在大纲中(这反而是更透明、更可访问的做法)
- SEO 或文档结构要求副标题与主标题强关联 → 用 aria-labelledby:给副标题设 id,主标题加 aria-labelledby="sub-id"
真正容易被忽略的是:即使你现在写了 hgroup,它也不会改变任何运行时行为——浏览器、爬虫、屏幕阅读器都当它不存在。删掉它,比改写它更安全、更轻量、更符合当前规范。
立即进入“夸克AI手把手教你,操作像呼吸一样简单!☜☜☜☜☜点击进入”;
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










