拾光 HTML从头到尾,读懂标记语言

第四章 · 结构

语义化结构:让每个标签说出自己的身份

页面能显示,并不等于页面写对了。这一章谈的是结构——当浏览器、搜索引擎和屏幕阅读器一起读你的页面时, 它们能否看懂哪里是导航、哪里是正文、哪里只是旁注。语义化不是额外的装饰, 而是 HTML 最初的设计意图:让内容自己说明自己。

阅读约 22 分钟 15 个示例 进阶难度 含实时预览

为什么要语义化:从「div 汤」说起

很多页面在视觉上无可挑剔,源代码却是一片 div 汤:所有的区块都用 <div> 堆出来,靠 class 名字互相区分。浏览器当然能把它画出来, 但你把这堆标签交给别人、交给搜索引擎、交给屏幕阅读器,它们只能看到一层又一层没有名字的盒子。

先看两种写法。它们在浏览器里几乎长得一模一样,差别藏在「读」的方式里。

html 写法一:div 汤,结构只有 class 知道
<div class="top">
  <div class="logo">拾光笔记</div>
  <div class="menu">
    <div class="item">首页</div>
    <div class="item">归档</div>
  </div>
</div>

<div class="wrap">
  <div class="post">
    <div class="title">一场雨的时间</div>
    <div class="text">雨落在瓦上,声音很轻。</div>
  </div>
  <div class="side">关于我</div>
</div>

<div class="bottom">&copy; 2026 拾光笔记</div>
html 写法二:用元素说明每块内容是什么
<header>
  <a href="/">拾光笔记</a>
  <nav>
    <a href="/">首页</a>
    <a href="/archive">归档</a>
  </nav>
</header>

<main>
  <article>
    <h1>一场雨的时间</h1>
    <p>雨落在瓦上,声音很轻。</p>
  </article>
  <aside>关于我</aside>
</main>

<footer>&copy; 2026 拾光笔记</footer>

在第二种写法里,即使一行 CSS 都不写,浏览器也知道:最上面是页头,中间是主导航, 主内容区里有一篇可以独立阅读的文章,旁边是一块 supplementary 的旁注,最下面是页脚。 这个「知道」,会同时被四类使用者受益:

受益者具体收益
机器与辅助技术屏幕阅读器可以按地标(landmark)跳转,直接抵达正文或导航,而不必逐行听完整个页面。
搜索引擎标题层级、文章边界、发布时间、导航区域都变得可识别,更容易判断页面主题与内容权重。
开发者自己半年后回来看源码,<article> 比 <div class="post-box"> 更让人一眼踏实。
内容复用文章、评论、卡片有了清晰边界,做 RSS、做聚合、做阅读模式时都不必重新猜结构。

需要特别强调的是:class 名字不构成语义。<div class="header"> 对人来说读得懂,对机器来说仍然是一个没有身份的 div。语义来自元素本身的含义, 或者来自 ARIA 角色;换名字只是给人看的注释。

一个温和的提醒

语义化不是为了「政治正确」地堆标签。如果一块内容确实只是布局用的盒子,用 <div> 就是正确答案。真正的问题是:所有东西都退化成 div,连明确有身份的内容也不肯给它名字。

页面骨架:七个地标元素

HTML5 提供了一组描述页面宏观结构的元素,它们大多会映射为辅助技术里的「地标」。 先看一份完整的骨架,注意每一层的关系,而不是记住标签的顺序。

html 一页完整的语义骨架
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>山间笔记</title>
</head>
<body>
  <header>
    <p>拾光笔记</p>
    <nav aria-label="主导航">
      <a href="/">首页</a>
      <a href="/archive">归档</a>
    </nav>
  </header>

  <main>
    <article>
      <header>
        <h1>一场雨的时间</h1>
        <p>发布于 <time datetime="2026-11-02">11 月 2 日</time></p>
      </header>
      <p>雨落在瓦上,声音很轻。</p>
    </article>

    <aside aria-label="侧栏">
      <h2>关于我</h2>
      <p>写字,也写代码。</p>
    </aside>
  </main>

  <footer>
    <p>&copy; 2026 拾光笔记</p>
  </footer>
</body>
</html>
<header> 站点或区块的「页头」:品牌、标题、导航、搜索都可以放。页面级 header 全页一个,文章内部还可以有自己的 header,所以它可以出现多次。
<nav> 一组主要导航链接的容器。注意是「主要」:页脚里零散的一行链接、正文里的相关阅读,不必都包成 nav。一个页面可以有多个 nav,用 aria-label 区分,例如「主导航」「面包屑」。
<main> 页面唯一的主体内容。跳过导航后,屏幕阅读器用户最想抵达的就是它。全页只能有一个可见的 main,且不能嵌套在 article、aside、nav、header、footer 里面。
<article> 可以独立存在的完整内容:一篇博文、一条评论、一张商品卡、一则新闻。判断标准是「单独拿出去还能被理解」。
<section> 文章或页面内部的一个主题分区,通常配一个标题。没有标题的 section 在辅助技术里等同于一个匿名区域,那还不如用 div。
<aside> 与主内容相关、但可以略过的旁注:作者简介、相关链接、广告、名词解释。它不是「侧边栏」这个词的翻译,而是一种内容关系。
<footer> 页脚:版权、联系方式、备案信息、文章标签。和 header 一样可以出现多次,文章内部也可以有 footer。
<header><nav><main><article> <section><aside><footer> <hgroup><search><figure>

这些元素同时承担「文档结构」和「可访问性地标」两重职责。浏览器会为它们生成隐式角色: header 对应 banner,nav 对应 navigation,main 对应 main,aside 对应 complementary, footer 对应 contentinfo,article 对应 article,带可访问名称的 section 对应 region。 也正因为有隐式角色,你不需要再写 role="navigation" 之类的冗余属性。

最后记住几条硬规则与软规则。硬规则是:main 只能有一个;header 与 footer 可以重复; main 不能放进 article。软规则是:section 最好有标题;nav 只包主要导航;aside 的内容必须与主内容相关。 硬规则写错会被校验器挑出来,软规则写错则会被使用辅助技术的人默默承受。

html 嵌套的合法与不合法
<!-- 合法:article 内部可以有自己的 header 与 footer -->
<article>
  <header><h2>标题</h2></header>
  <p>正文</p>
  <footer>标签:随笔</footer>
</article>

<!-- 不合法:main 不能嵌套在 article 里,也不该出现第二个 -->
<article>
  <main>……</main>
</article>

<!-- 不推荐:section 没有标题,等于一个匿名盒子 -->
<section>
  <p>一段没有名字的内容</p>
</section>

<!-- 推荐:给它一个标题,或者干脆用 div -->
<section aria-labelledby="sec-notes">
  <h2 id="sec-notes">读书笔记</h2>
  <p>……</p>
</section>

article、section 与 div 怎么选

这是语义化里被问得最多的一组选择。与其背定义,不如用一句判断:「如果这段内容被单独拿走、 放到别的页面里,读者还能完整理解吗?」能,用 article;不能,但它是一个有主题的段落, 用 section;如果连「主题」都谈不上,只是为布局或脚本服务,用 div。

你在写什么选择理由
博客列表里的每一篇文章<article>每篇都能独立发布、被单独阅读与转载。
文章下面的每条评论<article>评论有作者、时间、内容,本身就是完整的一条。
文章内部「清晨」「黄昏」两个主题段<section>它们依附于这篇文章,离开上下文便不完整。
页面上「关于我们」的主题区块<section>有明确主题,通常带一个 h2。
flex 布局用的一层包裹<div>纯粹为了排版,没有任何内容含义。
与主内容相关但可略过的推荐位<aside>它是内容关系,不是布局位置。
html 同一页面里的三种容器
<!-- 两篇各自独立的文章:article 并列 -->
<article>
  <h2>把日子过慢一点</h2>
  <p>……</p>
</article>

<article>
  <h2>窗外的树</h2>
  <p>……</p>
</article>

<!-- 一篇文章内部的主题分段:section 嵌套 -->
<article>
  <h1>秋日手记</h1>
  <section>
    <h2>清晨</h2>
    <p>……</p>
  </section>
  <section>
    <h2>黄昏</h2>
    <p>……</p>
  </section>
</article>

<!-- 只为布局:div 是正经工具,不必内疚 -->
<div class="card-grid">
  <div class="card-cell">……</div>
</div>

还有两个容易混淆的点。第一,article 可以嵌套:一篇博客是 article, 它下面的评论也是 article,这在规范里完全合法,因为评论确实可以独立存在。 第二,section 不是「更语义化的 div」,它有明确的内容边界要求; 如果你的区块只是为了把元素排成两列,用 div 反而更诚实。

常见误用

把页面切成一堆 <section>,每个都只放一个卡片,且都不写标题。这不是语义化,只是把 div 换了名字,还额外制造了无名的 region 噪音。

内容分组:让引用、图注与补充信息各归其位

骨架之外,还有一批描述「内容性质」的元素。它们平时不显眼,却能在关键处表达很细腻的关系。 下面按使用频率依次说明。

figure 与 figcaption:带说明的独立内容

图片、图表、代码片段、诗歌,都可以放进 <figure>。它表示「一段相对独立的内容, 通常配有说明」。说明写在 <figcaption> 里,位置可以在图前也可以在图后, 但建议放在后面,符合阅读顺序。

html 图片与图注
<figure>
  <img src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='480' height='300'%3E%3Crect width='480' height='300' fill='%23e9f0ea'/%3E%3Ctext x='240' y='158' text-anchor='middle' fill='%23587768' font-size='18'%3E%E7%A4%BA%E4%BE%8B%E5%9B%BE%E7%89%87%3C/text%3E%3C/svg%3E"
       alt="雾中石阶的示意插画" width="480" height="300">
  <figcaption>清晨的雾还没散,石阶上留着昨夜的水痕。</figcaption>
</figure>

blockquote、cite 与 address

<blockquote> 表示一段来自他处的引用,cite 属性可以给出出处 URL, 但它不会显示,也不该用来代替可见的来源说明。作品名用 <cite> 元素包裹。 <address> 表示「最近的 article 或 body 的联系信息」,通常包含邮箱、电话、地址, 并可以配合 <br> 分行;它不是给任意地址文本用的。

html 引用、出处与联系信息
<blockquote cite="https://example.com/essay">
  <p>慢一点,才能听见日子落地的声音。</p>
</blockquote>
<p>—— 引自 <cite>《慢下来的练习》</cite></p>

<address>
  写信给我:<a href="mailto:hi@example.com">hi@example.com</a><br>
  杭州 · 西湖边
</address>

hgroup 与 search:两个较新的补充

<hgroup> 用来把主标题和紧邻的副标题、标语组合在一起,让大纲只把主标题当作这一层的标题。 <search> 是较新的元素,用来包裹站内搜索这类「查找」表单,语义比一个普通 form 更明确。 遇到不支持的旧浏览器,它们会退化成普通容器,不影响使用。

html 标题组与搜索区
<hgroup>
  <h2>秋日手记</h2>
  <p>一些关于光线、茶与字的记录</p>
</hgroup>

<search>
  <form action="/search" method="get">
    <label for="q">站内搜索</label>
    <input id="q" name="q" type="search">
    <button type="submit">搜索</button>
  </form>
</search>

details 与 summary:先折叠,再展开

当一段补充信息不需要一开始就占据视线,可以用 <details> 包起来, 它天然支持点击展开与收起,不写一行 JavaScript。标题必须是第一个 <summary>。 这里只讲语义与基本用法,键盘行为、焦点与样式定制留到进阶章。

html 可折叠的补充说明
<details>
  <summary>这篇文章适合谁读?</summary>
  <p>适合已经能写完整页面、但还想把结构写得更清楚的人。</p>
</details>

<details open>
  <summary>读完之后能做什么?</summary>
  <p>能判断一段内容该用 article、section 还是 div。</p>
</details>
小结

分组元素的价值在于「关系」:图与图注、引用与出处、标题与副标题、问题与答案。关系写清楚了,样式怎么改都不会丢信息。

标题层级与文档大纲

h1 到 h6 是文档的骨架。浏览器曾经尝试实现过「大纲算法」, 按 section 嵌套自动计算标题层级,但主流浏览器最终都没有完整实现它。 不过这并不意味着标题层级不重要:屏幕阅读器仍然按 h1–h6 提供「按标题跳转」, 搜索引擎仍然用它判断内容结构,阅读模式插件也依赖它生成目录。

实践上遵循三条就够:一个页面一个 h1;层级逐级递进,不跳级; 标题描述内容,而不是「更多」「点击这里」。标题的视觉大小交给 CSS, 不要让「想要小一点的字」决定你选 h4 还是 h3。

html 三种常见的标题错误
<!-- 错误一:从 h2 跳到 h4,层级断裂 -->
<h2>第一章</h2>
<h4>1.1 小节</h4>

<!-- 错误二:为了字号选标签,而不是为了结构 -->
<h3 class="tiny">一行想变小的小标题</h3>
<!-- 正确做法:保持 h3,用 CSS 控制字号 -->

<!-- 错误三:把每个段落都写成 h2,标题失去区分度 -->
<h2>关于我们</h2>
<h2>我们成立于 2019 年</h2>
<h2>我们喜欢写字</h2>

一份健康的标题树,应该像一本书的目录:一眼能看出几章、每章几节、节与节是否平级。 如果遮住正文只看标题,读者仍然能复述页面讲了什么,那这份大纲就合格了。

html 层级清晰的标题树
<h1>秋日手记</h1>
<p>一些关于光线、茶与字的记录。</p>

<h2>清晨</h2>
<p>雾还没散,石阶上有昨夜的水痕。</p>

<h3>一杯茶的时间</h3>
<p>水汽升起来,字也慢了下来。</p>

<h2>黄昏</h2>
<p>光从西边斜进来,落在书页上。</p>

还有一个细节:卡片、侧栏、评论区里的标题,要放在整页大纲里思考。 如果整页的正文小节是 h2,那么卡片标题通常该是 h3;不要因为「卡片看起来很小」 就给它 h5。层级是关系,不是尺寸。

布局实战:一整页博客的结构

把前面的元素组合起来,就是一个真实可用的博客页。下面的示例带着少量 CSS, 只为让结构在预览里看得清楚;真正值得读的是 HTML 部分——每一层都在回答「这是什么」。

html 语义化博客页:页头、正文、侧栏、页脚
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>山间笔记</title>
  <style>
    body { margin: 0; font-family: sans-serif; color: #3a3631; background: #faf7f0; }
    header, main, footer { max-width: 720px; margin: 0 auto; padding: 0 20px; }
    header { display: flex; justify-content: space-between; align-items: center; padding-top: 20px; }
    nav a { margin-left: 14px; color: #587768; text-decoration: none; }
    main { display: grid; grid-template-columns: 2fr 1fr; gap: 24px; margin-top: 28px; }
    article h1 { font-size: 24px; margin-bottom: 4px; }
    article .meta { color: #978d7f; font-size: 13px; }
    aside { background: #e9f0ea; border-radius: 10px; padding: 14px; font-size: 13px; }
    footer { border-top: 1px solid #e7dece; margin-top: 28px; padding: 14px 20px; font-size: 12px; color: #978d7f; }
  </style>
</head>
<body>
  <header>
    <p><strong>拾光笔记</strong></p>
    <nav aria-label="主导航">
      <a href="/">首页</a>
      <a href="/archive">归档</a>
      <a href="/about">关于</a>
    </nav>
  </header>

  <main>
    <article>
      <h1>一场雨的时间</h1>
      <p class="meta">发布于 <time datetime="2026-11-02">11 月 2 日</time></p>
      <p>雨落在瓦上,声音很轻。我把窗推开一条缝,让潮气进来。</p>
      <p>这样的天气适合写字,也适合什么都不做。</p>
    </article>

    <aside aria-label="关于作者">
      <h2>关于我</h2>
      <p>写字,也写代码。住在西湖边。</p>
    </aside>
  </main>

  <footer>
    <p>&copy; 2026 拾光笔记</p>
  </footer>
</body>
</html>

逐层复盘:最外层 header 承担品牌与主导航;main 把页面的主体圈出来; 文章用 article,因为它是可以独立发布的一篇;发布时间用 time 并给出机器可读的 datetime;侧栏用 aside 并加 aria-label, 让地标有名字;页脚用 footer。

注意这里没有给每个区块都套 section。文章只有两段正文,没有主题分区, 所以不需要 section;布局的两列由 CSS Grid 完成,和 HTML 语义无关。 这正是「结构归结构,表现归表现」的样子。

动手改一改

把预览里的 article 换成 div class="article",页面看起来不会变。再打开浏览器的无障碍面板,观察「地标」列表少了什么——这就是语义化最直观的收益。

语义化、SEO 与可访问性

这三件事经常被分开讲,其实共用同一套底层结构。搜索引擎的爬虫和屏幕阅读器一样, 拿不到你的视觉设计,只能读 DOM。你给结构越清楚,它们越容易理解。

你写的辅助技术看到的角色实际作用
<header>banner可跳转到页头,快速找到品牌与导航。
<nav>navigation列出页面所有导航区,按名字区分。
<main>main一键跳到正文,绕过重复的导航。
<article>article识别独立内容单元,便于逐篇浏览。
<aside>complementary标记旁注,用户可以选择略过。
<footer>contentinfo快速抵达版权与联系信息。
带标题的 <section>region成为有名字的区域,可被地标列表列出。

在 SEO 层面,语义化不是某种「排名开关」,而是让内容更容易被正确理解的基础设施: 标题层级说明主题与子主题,article 划出正文边界,time 给出时间, nav 帮助识别站内链接结构。再加上有意义的链接文字、准确的 alt、 与内容一致的 title,搜索引擎才能把你和「标题党」区分开。

html 一份地标清单,长这样
<header>                          → banner
  <nav aria-label="主导航">        → navigation
<main>                            → main
  <article>                       → article
  <aside aria-label="关于作者">    → complementary
<footer>                          → contentinfo

可访问性方面还有两个细节值得顺手做掉:其一,在 body 开头放一个「跳到正文」的链接, 让它平时隐藏、聚焦时出现,键盘用户可以一次跳过几十个导航项;其二,导航如果不止一个, 一定用 aria-label 起名,否则屏幕阅读器会读出两个一模一样的「导航」。

不要过度 ARIA

原生元素已经有隐式角色,再补 role="navigation"、role="main" 属于重复劳动,写错反而更糟。原则是:能用原生元素,就不用 ARIA。

常见反模式:看起来对,读起来不对

下面这些写法都能正常显示,甚至在视觉上很精致,但它们在结构层面丢失了信息。 逐条对照,看看自己中了几条。

  • div 套 div 做整页布局。页头、导航、正文、页脚全部是 div,机器无法建立地标。
  • 卡片的标题只是加粗文字。用 div class="title" 代替 h3,标题导航里完全找不到它。
  • 列表用 div 模拟。视觉上是一列,语义上什么也不是,屏幕阅读器不会播报「共 3 项」。
  • 文章缺少标题。正文直接从段落开始,大纲里这一篇是隐形的。
  • 一个页面多个 h1。每个区块都想要「最重要」,结果整页没有重点。
  • 把 section 当样式容器。几十个无标题 section,地标列表变成噪音。
  • 链接文字写「点击这里」。脱离上下文后,链接列表里全是无法分辨的条目。
html 卡片:从「看起来是标题」到「真的是标题」
<!-- 反例:只有视觉上的标题 -->
<div class="card">
  <div class="card-title">秋日手记</div>
  <div class="card-desc">一些关于光线的记录。</div>
</div>

<!-- 正例:卡片可独立成篇,标题用 h3,内容用 p -->
<article class="card">
  <h3>秋日手记</h3>
  <p>一些关于光线的记录。</p>
</article>
html 清单:div 与 ul 的区别
<!-- 反例:用 div 模拟列表 -->
<div class="list">
  <div class="row">茶叶</div>
  <div class="row">热水</div>
  <div class="row">一只杯子</div>
</div>

<!-- 正例:它本来就是一份清单 -->
<ul>
  <li>茶叶</li>
  <li>热水</li>
  <li>一只杯子</li>
</ul>

反模式的共同点是「用表现替代含义」:因为看起来像标题,就画一个标题; 因为看起来是一列,就摆成一列。语义化要做的,是把「看起来像」还原成「本来就是」。 这不是额外的工作量,而是把同样的标签用在对的地方。

检查清单与验证工具

写完一页,花三分钟过一遍下面这份清单。它不能代替理解,但能挡住大多数低级问题。

  • 页面有且只有一个 main,且没有嵌套在 article、aside、nav 等元素里。
  • 页头、导航、正文、页脚使用对应地标元素,而不是清一色的 div。
  • 每个 section 都有标题,或干脆改成 div。
  • 标题从 h1 开始逐级递进,没有跳级,也没有为了字号而选标签。
  • 文章、评论、卡片等独立内容使用 article。
  • 多个 nav 或 aside 带有 aria-label。
  • 没有重复的 id,没有未闭合的标签。
  • 链接文字能独立表意,不出现「点击这里」「更多」。
工具能发现什么
W3C Markup Validator标签闭合、嵌套合法性、属性拼写、重复 id 等规范问题。
浏览器无障碍面板查看地标树与标题大纲,确认屏幕阅读器会读到什么。
标题大纲类插件把页面标题抽成目录,检查层级是否断裂、是否有缺失的标题。
Lighthouse可访问性与 SEO 的自动检查,能提示缺少 alt、标题顺序异常等。
axe DevTools更细的规则扫描,适合在开发阶段随手运行。

工具给出的常常是「症状」,真正的判断仍然在你这里。校验器说标签合法, 不代表结构合理;Lighthouse 分数很高,也不代表读起来顺畅。 把工具当作第二双眼睛,而不是唯一的裁判。

下一步

结构写清楚之后,往页面里放图片、音视频和嵌入内容,同样要照顾语义与体验。下一章进入多媒体与嵌入。