COURSE 01 — STRUCTURE

HTML · 结构之骨

网页的一切,都从一段被标签包裹的文字开始。这一章我们从最基础的文档结构讲起, 依次走过文字、链接、图片、列表、表格、表单与语义化,最后亲手搭出一张个人主页的骨架。

9 个章节 20+ 段代码 约 4 小时 难度 · 入门
学习进度 0%
01

认识 HTML:网页的骨架

HyperText Markup Language · 用标签描述内容

HTML(HyperText Markup Language,超文本标记语言)是构建网页的标准语言。 它不是编程语言——没有变量、循环和判断,它做的只有一件事: 用一对对标签,把文字、图片、链接等内容组织成有层次的结构。

可以把做一个网页想象成建一座房子:HTML 是钢筋与墙体,决定哪里有门、哪里有窗; CSS 是装修与家具,决定墙漆的颜色、桌子的位置;JavaScript 则是水电与开关, 让灯能亮、门能开。三者各司其职,缺一不可。

技术职责回答的问题类比
HTML结构 / 内容这里是什么?墙体与房间
CSS表现 / 样式它长什么样?装修与配色
JavaScript行为 / 交互操作后会发生什么?电路与开关

浏览器是怎么把 HTML 变成页面的

当你在地址栏敲下回车,浏览器大致会经历这样几个步骤:

  1. 请求资源:向服务器请求 HTML 文件,同时可能请求 CSS、JS、图片。
  2. 解析 HTML:逐行读取标签,构建出一棵「DOM 树」,每个标签都是树上的一个节点。
  3. 解析 CSS:构建样式规则,和 DOM 结合生成渲染树。
  4. 布局与绘制:计算每个盒子的大小与位置,再把像素画到屏幕上。

理解这件事很重要:你写下的每一个标签,都会成为 DOM 树上真实存在的节点。 结构写得越清晰,后面用 CSS 排版、用 JS 操作就越轻松。

标签、元素与属性

HTML 的基本单位是元素,它由开始标签、内容和结束标签组成:

HTML
<p class="note">这是一段文字</p>

<!-- 拆开来看 -->
<p class="note">      开始标签(p 是标签名,class 是属性)
  这是一段文字          内容
</p>                   结束标签
  • 标签名:如 p、h1、img,表示元素的类型。
  • 属性:写在开始标签里,用来补充信息,如 class、id、src、href。
  • 空元素:有些标签没有内容,也不需要结束标签,例如 <img>、<br>、<input>。
  • 注释:<!-- 注释内容 -->,只写给自己或同事看,页面不会显示。

块级元素与行内元素

HTML 元素在默认情况下大致分为两类,理解它们有助于后续的布局:

类型特点常见标签
块级元素独占一行,可以设置宽高,像一个个堆叠的盒子div p h1 ul section
行内元素跟随文字排列,宽高由内容决定span a strong em img

这条规则不是绝对的——CSS 的 display 属性可以随时改变元素的行为,我们会在 CSS 课程里详细展开。

一句话记住

HTML 负责「这是什么」,CSS 负责「它长什么样」,JavaScript 负责「它能做什么」。

HTML 是编程语言吗?为什么?

不是。HTML 没有变量、条件判断、循环等逻辑能力,它只是一种标记语言,用标签给内容赋予结构和含义。真正的逻辑由 JavaScript 完成。

02

第一份 HTML 文档

DOCTYPE · html · head · body

一个完整、规范的 HTML 文档,有固定的「开场白」。 把它背下来是值得的——之后你写的每一页,都从这几行开始。

HTML
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>我的第一页</title>
</head>
<body>
  <h1>你好,世界</h1>
  <p>这是我写下的第一行网页。</p>
</body>
</html>
代码作用
<!DOCTYPE html>声明这是 HTML5 文档,让浏览器以标准模式渲染,避免怪异模式。
<html lang="zh-CN">文档根元素。lang 声明页面语言,帮助搜索引擎、屏幕阅读器与翻译工具。
<head>存放「给浏览器看」的信息:编码、标题、样式、描述等,不直接显示在页面上。
<meta charset="UTF-8">声明字符编码。缺失它,中文很容易变成乱码。
<meta name="viewport">移动端视口设置,让页面按设备宽度渲染,是响应式的基础。
<title>浏览器标签页上的标题,也是搜索结果的标题,必填。
<body>页面正文,所有用户能看到的内容都放在这里。

亲手运行第一个页面

下面的代码可以直接运行。试着在代码里改几个字,再点「运行代码」,看看预览窗口的变化。

Live Preview
HTML · 第一个页面
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>我的第一页</title>
</head>
<body>
  <h1>你好,世界</h1>
  <p>这是我写下的第一行网页。试着把它改成你自己的句子。</p>
  <p>—— 青禾手记</p>
</body>
</html>

文件命名与书写习惯

  • 主文件通常命名为 index.html,这是服务器默认寻找的首页。
  • 文件名使用小写英文、数字与连字符,如 my-first-page.html,避免空格与中文。
  • 使用两个空格缩进,让嵌套关系一目了然;结构比美观更重要,但美观会救未来的你。
  • 保存时确保编码是 UTF-8,与 meta charset 保持一致。
三个常见错误

1. 忘记写 charset,中文显示为乱码;
2. 把正文写在 <head> 里,页面一片空白;
3. 标签忘记闭合,导致后面的结构全部错位。

为什么 <meta charset="UTF-8"> 必须放在 head 的前面?

浏览器需要尽早知道用什么编码来解码字节流。如果这行出现得太晚,它可能已经用错误编码解析了前面的内容,导致中文乱码。所以它应该尽量靠前。

03

文字与段落

标题 · 段落 · 强调 · 引用 · 代码 · 实体字符

文字是网页里最常见的内容。HTML 提供了丰富的文本标签, 它们不仅决定「显示成什么样」,更重要的是告诉浏览器「这段文字是什么含义」。

标题:h1 到 h6

h1 到 h6 表示六级标题,数字越小层级越高。 一个页面通常只有一个 h1(页面主标题),其余标题按层级递进, 不要为了字体大小而跳级——字号交给 CSS,标签只表达结构。

HTML
<h1>青禾手记</h1>
<h2>第一章 · 前端是什么</h2>
<h3>1.1 从浏览器说起</h3>
<h3>1.2 三种语言的分工</h3>
<h2>第二章 · 第一个页面</h2>

段落与换行

  • <p>:段落。每个段落独占一块,前后会自动留出间距。
  • <br>:强制换行,常用于诗歌、地址这类需要在同一段内换行的内容。
  • <hr>:一条分隔线,表示话题的转换。
不要用 br 制造间距

连续写多个 <br> 来撑开距离是坏习惯。间距属于样式,应该用 CSS 的 margin 或 padding 控制。

带语义的强调

<strong> 表示重要,<em> 表示强调语气, 屏幕阅读器会用不同语调朗读它们。<b> 和 <i> 只改变外观,不带语义,现在更推荐使用前两者。

HTML
<p>请务必在 <strong>周五之前</strong> 提交作业。</p>
<p>我不是不想去,<em>是真的起不来</em>。</p>
<p><small>以上内容仅为示例,请勿当真。</small></p>
<p>原价 <del>¥129</del>,现价 <ins>¥79</ins>。</p>
<p>水的化学式是 H<sub>2</sub>O,面积单位是 m<sup>2</sup>。</p>
<p>把重点 <mark>标记出来</mark>,一眼就能看见。</p>

引用、代码与缩写

标签含义示例场景
blockquote块级引用,通常独自成段引用一段书中的话
q行内引用,浏览器会自动加引号句子中引用一个短语
cite引用作品的标题《活着》
code一段代码行内的函数名
pre保留空格与换行多行代码块
kbd键盘输入Ctrl + S
abbr缩写,配合 title 给出全称HTML
time日期或时间,配合 datetime2026-03-21
HTML
<blockquote>
  <p>慢慢来,比较快。</p>
  <cite>—— 青禾手记</cite>
</blockquote>

<p>按下 <kbd>Ctrl</kbd> + <kbd>S</kbd> 即可保存。</p>
<p><abbr title="HyperText Markup Language">HTML</abbr> 是网页的结构语言。</p>
<p>发布于 <time datetime="2026-03-21">2026 年 3 月 21 日</time></p>

<pre><code>const name = "青禾";
console.log(name);</code></pre>

实体字符:如何显示 < 和 >

有些字符在 HTML 里有特殊含义(例如尖括号会被当成标签),需要用「实体」来表示:

写法显示结果说明
&lt;<小于号
&gt;>大于号
&amp;&和号
&quot;"双引号
&nbsp;不换行空格防止词语被拆行
&copy;©版权符号
&mdash;—长破折号
Live Preview
HTML · 一篇文章
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <style>
    body { max-width: 560px; margin: 22px auto; padding: 0 18px;
           font-family: "Songti SC", serif; line-height: 1.9; color: #3b453f; }
    h1 { font-size: 25px; padding-bottom: 10px; border-bottom: 1px solid #e4dfd3; }
    .meta { color: #97a29a; font-size: 12px; letter-spacing: 1px; }
    blockquote { margin: 16px 0; padding: 8px 16px; color: #5f7d6d;
                 border-left: 3px solid #cfe3d6; background: #f4f8f5; }
    mark { background: #f5ead4; padding: 0 3px; }
    code { background: #eef4ef; padding: 1px 5px; border-radius: 4px; font-size: 13px; }
  </style>
</head>
<body>
  <h1>春日读书笔记</h1>
  <p class="meta">写于 2026 年 3 月 21 日 · 晴</p>

  <p>今天读到一句话:<strong>慢慢来,比较快</strong>。
     它让我想起自己刚学前端时,总想一天看完所有教程。</p>

  <p>书里反复提到 <em>心流</em> 这个词——
     当注意力完全放在当下,时间反而变得宽阔。</p>

  <blockquote>“把注意力放回当下,时间就会变得宽阔。”</blockquote>

  <p>推荐指数:<mark>四颗星</mark>,
     适合 <abbr title="刚接触某一领域的人">初学者</abbr>阅读。</p>

  <p>今天练习的命令:<code>git commit -m "note"</code></p>
</body>
</html>
strong 和 b 看起来一样粗,它们的区别是什么?

strong 带有「重要」的语义,屏幕阅读器会加重语气朗读,搜索引擎也会重视;b 只是视觉加粗,没有语义。同理,em 有强调语义,i 只是斜体样式。

04

链接、图片与路径

a · img · figure · 相对路径与绝对路径

超文本之所以「超」,就是因为链接。它把一个个孤立的页面连成一张网。 而图片,则是最直观的表达方式。这一节我们同时要弄懂一件容易被忽略的事:路径。

超链接 a

HTML
<!-- 跳转到另一个页面 -->
<a href="css.html">去学 CSS</a>

<!-- 在新标签页打开外部链接(建议加上 rel) -->
<a href="https://developer.mozilla.org/zh-CN/" target="_blank" rel="noopener noreferrer">
  MDN 文档
</a>

<!-- 跳到本页的某个位置 -->
<a href="#ch6">跳到表单一节</a>

<!-- 下载文件 -->
<a href="assets/resume.pdf" download>下载简历</a>

<!-- 发邮件 / 打电话 -->
<a href="mailto:hello@example.com">给我写信</a>
<a href="tel:+8613800000000">拨打电话</a>
属性作用
href目标地址,可以是网址、相对路径或锚点
target_self 当前窗口(默认),_blank 新标签页
rel与目标页的关系;新窗口打开时建议加 noopener noreferrer,避免安全与性能问题
title悬停时显示的提示文字
download提示浏览器下载而不是打开

相对路径与绝对路径

假设项目结构如下:

TREE
project/
├── index.html
├── css.html
├── assets/
│   ├── css/style.css
│   └── img/botanical.svg
└── pages/
    └── about.html
  • css.html:同级文件,直接写文件名。
  • ./assets/img/botanical.svg:当前目录下的文件,./ 可省略。
  • ../index.html:返回上一级目录。
  • /assets/img/botanical.svg:从网站根目录开始(注意本机直接打开文件时不适用)。
  • https://...:绝对地址,指向互联网上的完整资源。

图片 img

HTML
<img src="assets/img/botanical.svg"
     alt="浅绿色背景上的植物插画"
     width="480"
     height="320"
     loading="lazy">
属性是否必填说明
src必填图片地址
alt强烈建议图片无法显示时的替代文字,也是屏幕阅读器朗读的内容。纯装饰图片可写 alt=""
width / height建议提前告诉浏览器尺寸,避免图片加载后页面跳动
loading可选lazy 表示懒加载,滚动到附近才下载

图文并茂:figure 与 figcaption

当图片需要配一段说明文字时,用 figure 把图片和说明包在一起, figcaption 就是图注。它表达的是「这张图和这段说明是一体的」。

Live Preview
HTML · 图文卡片
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <style>
    body { margin: 0; padding: 24px; background: #f8f6f0;
           font-family: system-ui, "Microsoft YaHei", sans-serif; }
    .card { max-width: 340px; margin: 0 auto; overflow: hidden;
            background: #fffdf9; border: 1px solid #e4dfd3; border-radius: 16px; }
    .card img { display: block; width: 100%; height: auto; }
    figcaption { padding: 10px 16px; font-size: 12px; color: #8a938d;
                 border-bottom: 1px dashed #e4dfd3; }
    .body { padding: 16px 18px 20px; }
    h2 { margin: 0 0 8px; font-size: 18px; color: #2e3833; }
    p { margin: 0 0 12px; font-size: 13.5px; color: #5a655f; }
    a { color: #4b6a5a; font-size: 13px; }
  </style>
</head>
<body>
  <figure class="card">
    <img src="assets/img/botanical.svg"
         alt="浅绿色圆形背景上,一株正在生长的植物"
         width="480" height="320">
    <figcaption>图 1 · 用 SVG 画的一株植物</figcaption>
    <div class="body">
      <h2>把日子过成植物</h2>
      <p>慢一点生长,也是一种生长。</p>
      <a href="https://developer.mozilla.org/zh-CN/" target="_blank" rel="noopener">
        去 MDN 继续阅读 →
      </a>
    </div>
  </figure>
</body>
</html>
图片格式怎么选

照片用 WebP 或 JPEG,需要透明背景的图形用 PNG 或 WebP,图标与插画优先用 SVG——它无论放大多少倍都清晰,体积还小。

什么时候应该写 alt=""?

当图片只是纯装饰、不承载任何信息时(例如一条分隔用的花纹),写空的 alt 可以让屏幕阅读器跳过它。只要图片包含信息,就必须用文字描述出来。

05

列表与表格

ul · ol · dl · table · 合并单元格

列表用来表达「一组同类的东西」,表格用来表达「行列对应的数据」。 它们都是高度结构化的内容,选对了标签,样式和可访问性都会省力很多。

三种列表

标签含义典型场景
ul无序列表,项目前是小圆点导航菜单、标签列表
ol有序列表,自动编号步骤、排行榜
dl描述列表,名称与说明成对出现术语表、常见问题
HTML
<ul>
  <li>HTML</li>
  <li>CSS</li>
  <li>JavaScript</li>
</ul>

<ol start="3">
  <li>打开编辑器</li>
  <li>新建 index.html</li>
  <li>写下第一行标签</li>
</ol>

<dl>
  <dt>DOM</dt>
  <dd>浏览器把 HTML 解析后形成的树状结构。</dd>
  <dt>FCP</dt>
  <dd>首次内容绘制,衡量页面打开速度的指标之一。</dd>
</dl>

列表可以嵌套:把一个完整的 ul 放进 li 里,就得到二级菜单。注意嵌套的列表必须在 li 内部,不能直接挂在 ul 下面。

表格的正确打开方式

一个规范的表格由标题、表头、表身与表尾组成:

  • caption:表格标题,写在 table 的第一个子元素位置。
  • thead / tbody / tfoot:分别表示表头、表身、表尾,便于样式与阅读。
  • th:表头单元格,默认加粗居中;td:普通数据单元格。
  • scope="col" 或 scope="row":告诉屏幕阅读器这个表头管的是列还是行。
  • colspan / rowspan:横向、纵向合并单元格。
Live Preview
HTML · 课程表
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <style>
    body { margin: 0; padding: 22px; background: #f8f6f0;
           font-family: system-ui, "Microsoft YaHei", sans-serif; }
    table { width: 100%; border-collapse: collapse; background: #fffdf9;
            font-size: 13px; border-radius: 10px; overflow: hidden; }
    caption { font-size: 15px; font-weight: 600; color: #4b6a5a;
              padding-bottom: 10px; text-align: left; }
    th, td { border: 1px solid #e4dfd3; padding: 9px 10px; text-align: center; }
    thead th { background: #e0ece4; color: #3f5f50; }
    tbody th { background: #f6f3ea; font-weight: 500; }
    tbody tr:hover td { background: #f9f7f0; }
  </style>
</head>
<body>
  <table>
    <caption>2026 春季 · 前端学习课表</caption>
    <thead>
      <tr>
        <th scope="col">时间</th>
        <th scope="col">周一</th>
        <th scope="col">周三</th>
        <th scope="col">周五</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <th scope="row">上午</th>
        <td>HTML</td>
        <td>CSS</td>
        <td>JavaScript</td>
      </tr>
      <tr>
        <th scope="row">午休</th>
        <td colspan="3">吃饭、散步、看看窗外</td>
      </tr>
      <tr>
        <th scope="row">下午</th>
        <td>练习</td>
        <td>练习</td>
        <td>小项目</td>
      </tr>
    </tbody>
  </table>
</body>
</html>
不要用表格做布局

在 CSS 还不成熟的年代,人们常用 table 拼页面。现在请把布局交给 Flexbox 与 Grid。表格只承载「数据」,否则语义会混乱,维护也会变得非常痛苦。

为什么表头要用 th 而不是 td?

th 有「表头」的语义,配合 scope 属性,屏幕阅读器能在朗读数据时自动带出对应的行列标题。用 td 加粗只是看起来像表头,读屏用户无法获得这层关系。

06

表单:与用户对话

form · input · label · 校验 · 无障碍

搜索框、登录页、问卷、评论区——所有需要用户输入的地方,都是表单。 表单看起来标签很多,但只要抓住「容器 + 控件 + 标签 + 校验」四件事,就理清了。

表单的基本结构

HTML
<form action="/submit" method="post">
  <label for="username">用户名</label>
  <input id="username" name="username" type="text" required>

  <button type="submit">提交</button>
</form>
  • action:数据提交到哪个地址;method:get 会把数据拼在网址后面,post 放在请求体里。
  • name:控件的名字,提交时以「name=value」的形式发送,没有 name 的控件不会被提交。
  • id:页内唯一标识,用来让 label 与控件关联。
  • label 的 for 必须等于控件的 id,点击文字也能聚焦输入框。

常用输入类型

type用途额外说明
text单行文本最基础的输入框
email邮箱移动端弹出邮箱键盘,自动校验格式
password密码输入内容显示为圆点
number数字可配合 min / max / step
date日期显示日期选择器
radio单选同一 name 为一组,互斥
checkbox多选同一 name 可选中多个
file文件上传配合 accept 限制类型
range滑块配合 min / max / step
color颜色选择返回十六进制色值
search搜索框部分浏览器会显示清除按钮
hidden隐藏字段用户看不见,但会随表单提交
submit提交按钮通常用 button 代替

约束校验属性

HTML
<input type="text" name="nickname"
       placeholder="2-10 个字符"
       required
       minlength="2"
       maxlength="10"
       autocomplete="nickname">

<input type="text" name="phone"
       pattern="^1[3-9]\d{9}$"
       title="请输入 11 位手机号">

<input type="number" name="age" min="1" max="120" step="1">

这些都是浏览器原生校验:不满足条件时无法提交,并给出提示。 比起自己写 JavaScript 校验,原生校验更省事,也天然支持无障碍。 CSS 还能用 :valid 与 :invalid 给合法/非法状态上色。

下拉框、多行文本与按钮组

HTML
<label for="city">所在城市</label>
<select id="city" name="city">
  <option value="">请选择</option>
  <option value="bj">北京</option>
  <option value="sh" selected>上海</option>
  <option value="gz">广州</option>
</select>

<label for="msg">想说的话</label>
<textarea id="msg" name="message" rows="4" placeholder="写点什么…"></textarea>

<fieldset>
  <legend>你的身份</legend>
  <label><input type="radio" name="role" value="student"> 学生</label>
  <label><input type="radio" name="role" value="worker"> 上班族</label>
</fieldset>
Live Preview
HTML · 报名表
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <style>
    body { margin: 0; padding: 24px; background: #f8f6f0;
           font-family: system-ui, "Microsoft YaHei", sans-serif; color: #3b453f; }
    form { max-width: 360px; margin: 0 auto; padding: 22px 24px;
           background: #fffdf9; border: 1px solid #e4dfd3; border-radius: 16px; }
    h2 { font-size: 17px; margin: 0 0 16px; color: #4b6a5a; }
    .field { margin-bottom: 14px; }
    label { display: block; font-size: 12.5px; margin-bottom: 5px; color: #5a655f; }
    input, select, textarea {
      width: 100%; padding: 8px 11px; font-size: 13px; font-family: inherit;
      border: 1px solid #e4dfd3; border-radius: 8px; background: #fff; outline: none;
    }
    input:focus, select:focus, textarea:focus { border-color: #6f8f7c; }
    input:valid { border-color: #c9dccf; }
    textarea { resize: vertical; }
    button { width: 100%; padding: 10px; border: none; border-radius: 999px;
             background: #4b6a5a; color: #fff; font-size: 13.5px; cursor: pointer; }
    button:hover { background: #405d4e; }
  </style>
</head>
<body>
  <form onsubmit="event.preventDefault(); alert('校验通过,示例不会真的提交。');">
    <h2>春季共学报名</h2>

    <div class="field">
      <label for="name">昵称</label>
      <input id="name" name="name" type="text" placeholder="2-10 个字符"
             required minlength="2" maxlength="10">
    </div>

    <div class="field">
      <label for="mail">邮箱</label>
      <input id="mail" name="email" type="email" placeholder="you@example.com" required>
    </div>

    <div class="field">
      <label for="level">前端基础</label>
      <select id="level" name="level">
        <option value="zero">零基础</option>
        <option value="some">会写一点 HTML</option>
        <option value="more">写过完整页面</option>
      </select>
    </div>

    <div class="field">
      <label for="note">想说的话</label>
      <textarea id="note" name="note" rows="3" placeholder="选填"></textarea>
    </div>

    <button type="submit">提交报名</button>
  </form>
</body>
</html>
无障碍提醒

每个输入控件都应该有可访问的名称。最稳妥的方式就是使用 label 并正确关联 for 与 id;不要只用 placeholder 代替标签,因为它一输入就消失了。

输入框写了 name="email" 但没有 label,会有什么问题?

屏幕阅读器只能读出「编辑框」,用户不知道要填什么;点击文字也无法聚焦。此外,如果连 name 都没有,这个输入框的值根本不会被表单提交。

07

语义化与页面结构

header · nav · main · article · section · aside · footer

早期我们习惯用一堆 div 拼页面,看起来能用,但浏览器、搜索引擎和读屏软件都不知道每一块是做什么的。 语义化标签的价值,就是把「这块是什么」写进结构里。

页面级语义标签

标签含义使用建议
header页头或某个区块的头部通常放 logo、标题、导航
nav导航链接组一个页面可以有多个,但主要导航通常只有一个
main页面主体内容每页只能有一个,且不应包含页头页脚
article独立、可单独分发的内容一篇博客、一条评论、一张卡片
section有主题的内容区块通常需要一个小标题
aside与主内容相关的旁支信息侧边栏、相关阅读、广告位
footer页脚或区块的尾部版权、联系方式、备案信息
figure独立的图文单元配图、代码片段、图表
address联系信息作者邮箱、地址

div 与 span 还需要吗

需要。当一块内容没有更合适的语义标签,只是单纯需要一个容器来做布局或加样式时,用 div(块级)或 span(行内)。 原则很简单:先找语义标签,找不到再用 div,而不是反过来。

HTML
<body>
  <header>
    <a href="/">青禾手记</a>
    <nav>
      <a href="#html">HTML</a>
      <a href="#css">CSS</a>
      <a href="#js">JavaScript</a>
    </nav>
  </header>

  <main>
    <article>
      <h1>我的第一篇笔记</h1>
      <p>……</p>
    </article>
    <aside>
      <h2>相关阅读</h2>
      <ul><li><a href="#">如何写好标题</a></li></ul>
    </aside>
  </main>

  <footer>
    <p>© 2026 青禾手记</p>
  </footer>
</body>
Live Preview
HTML · 语义化博客页
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <style>
    * { box-sizing: border-box; }
    body { margin: 0; background: #f8f6f0; color: #3b453f;
           font-family: system-ui, "Microsoft YaHei", sans-serif; font-size: 13px; }
    header { display: flex; justify-content: space-between; align-items: center;
             padding: 14px 22px; background: #fffdf9; border-bottom: 1px solid #e4dfd3; }
    header b { font-family: "Songti SC", serif; font-size: 16px; color: #4b6a5a; }
    nav a { margin-left: 14px; color: #7c8781; text-decoration: none; font-size: 12px; }
    .layout { display: grid; grid-template-columns: 1fr 150px; gap: 20px;
              padding: 22px; max-width: 640px; margin: 0 auto; }
    article { background: #fffdf9; border: 1px solid #e4dfd3; border-radius: 12px;
              padding: 20px 22px; }
    article h1 { font-family: "Songti SC", serif; font-size: 21px; margin: 0 0 8px; }
    article p { line-height: 1.9; color: #5a655f; }
    aside { background: #f1eee4; border-radius: 12px; padding: 14px 16px; font-size: 12px; }
    aside h2 { font-size: 12px; letter-spacing: .1em; color: #8a938d; margin: 0 0 8px; }
    aside a { display: block; color: #4b6a5a; text-decoration: none; margin-bottom: 6px; }
    footer { text-align: center; color: #a0a9a3; font-size: 11px; padding: 16px; }
  </style>
</head>
<body>
  <header>
    <b>青禾手记</b>
    <nav>
      <a href="#">首页</a><a href="#">归档</a><a href="#">关于</a>
    </nav>
  </header>

  <div class="layout">
    <main>
      <article>
        <h1>把网页写成一张纸</h1>
        <p>留白不是空,是让内容有呼吸的地方。</p>
        <p>当我开始用语义标签组织页面,结构忽然变得清晰起来。</p>
      </article>
    </main>
    <aside>
      <h2>相关阅读</h2>
      <a href="#">如何选择字体</a>
      <a href="#">留白的三种用法</a>
    </aside>
  </div>

  <footer>© 2026 青禾手记</footer>
</body>
</html>
三个小原则

1. 一页只有一个 main;
2. 标题层级不跳级,h2 下面才用 h3;
3. section 最好有标题,没有标题的纯布局容器用 div。

section 和 div 应该怎么选?

如果这块内容有明确主题、并且可以起一个小标题,用 section;如果只是为了布局或加样式、没有语义可言,用 div。

08

多媒体、meta 与发布

audio · video · iframe · SEO · 调试

走到这里,你已经能写出结构完整的页面了。最后一节,我们补上音视频、搜索引擎优化与调试发布这几块拼图。

音频与视频

HTML
<audio controls>
  <source src="assets/audio/rain.mp3" type="audio/mpeg">
  <source src="assets/audio/rain.ogg" type="audio/ogg">
  你的浏览器不支持音频播放。
</audio>

<video controls width="480" poster="assets/img/botanical.svg">
  <source src="assets/video/demo.mp4" type="video/mp4">
  <track src="assets/video/demo.vtt" kind="subtitles" srclang="zh" label="中文">
  你的浏览器不支持视频播放。
</video>
  • controls:显示播放控件,没有它用户无法操作。
  • source:提供多个格式,浏览器会挑第一个支持的。
  • poster:视频封面图。
  • track:字幕轨道,对无障碍非常重要。
  • 自动播放通常会被浏览器拦截;若必须自动播放,需要 muted 且 playsinline。

嵌入其他页面:iframe

HTML
<iframe src="https://example.com/map"
        title="地图"
        width="100%" height="300"
        loading="lazy"
        sandbox="allow-scripts allow-same-origin">
</iframe>

iframe 会在页面里开一个独立的小窗口。嵌入第三方内容时,务必加上 title(读屏需要)与 sandbox(限制权限),不要嵌入来路不明的页面。

meta 与 SEO 基础

HTML · head 区常用标签
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="一句话说明这个页面的内容,会出现在搜索结果里。">
<meta name="author" content="青禾">
<meta name="theme-color" content="#6f8f7c">

<!-- 社交平台分享卡片 -->
<meta property="og:title" content="青禾 · 前端手账">
<meta property="og:description" content="一册写给初学者的前端学习站。">
<meta property="og:image" content="assets/img/botanical.svg">
<meta property="og:type" content="website">

<!-- 页面标准地址,避免重复内容 -->
<link rel="canonical" href="https://example.com/html.html">

SEO 简易清单

  • 每页有且仅有一个 h1,且与页面主题相关。
  • title 与 description 写得具体,不要堆砌关键词。
  • 图片写清 alt,链接文字有意义(避免「点击这里」)。
  • 使用语义标签组织内容,让结构本身可读。
  • 页面体积、图片大小、懒加载,都会影响体验与排名。

调试与校验

  • 浏览器开发者工具:Elements 看 DOM 结构,Console 看报错,Network 看资源加载,Lighthouse 跑性能与无障碍评分。
  • W3C 校验器:把 HTML 粘贴进去,能查出漏闭合、属性写错等问题。
  • 先看控制台:页面不对时,第一件事永远是打开 Console,红字往往直接告诉你原因。

把页面放到互联网上

纯静态页面不需要服务器程序,常见的免费方案有 GitHub Pages、Netlify、Vercel 等: 把项目推送到仓库,开启 Pages,就能得到一个可访问的网址。 如果只是自己和朋友看,直接把整个文件夹发给对方,双击 index.html 也能打开。

本章小结

HTML 的学习重点不是「背多少标签」,而是养成两个习惯:用正确的标签表达正确的含义,以及写完就打开控制台看一眼。

viewport 这行 meta 是做什么的?

它告诉移动端浏览器「页面宽度等于设备宽度,初始缩放为 1」。没有它,手机浏览器会假装自己是 980px 宽的桌面屏,把页面缩小显示,字会变得很小,响应式布局也无从谈起。

09

综合练习:个人主页的骨架

把前面八节拼成一张完整的页面

现在,把学过的标签放到一起,为「你自己」写一张主页的结构。 先不要管好不好看,只关注:结构是否清晰、层次是否正确、每个标签是否用对了。

HTML · 个人主页骨架
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>林小满 · 前端学习者</title>
  <meta name="description" content="林小满的个人主页,记录前端学习与生活片段。">
</head>
<body>
  <header>
    <a href="#" class="logo">林小满</a>
    <nav aria-label="主导航">
      <ul>
        <li><a href="#about">关于我</a></li>
        <li><a href="#works">作品</a></li>
        <li><a href="#contact">联系</a></li>
      </ul>
    </nav>
  </header>

  <main>
    <section id="hero">
      <h1>你好,我是林小满</h1>
      <p>一个正在学习前端的设计爱好者,喜欢把界面写得干净一点。</p>
      <a href="#contact">和我聊聊 →</a>
    </section>

    <section id="about">
      <h2>关于我</h2>
      <p>白天做排版,晚上写代码。最近在系统学习 HTML、CSS 与 JavaScript。</p>
      <dl>
        <dt>正在学</dt><dd>JavaScript 与 DOM</dd>
        <dt>喜欢</dt><dd>宋体、留白、雨后</dd>
      </dl>
    </section>

    <section id="works">
      <h2>最近作品</h2>
      <article>
        <h3>一页式读书笔记</h3>
        <p>用 HTML 与 CSS 做的一张极简阅读卡片。</p>
        <a href="#">查看作品</a>
      </article>
    </section>
  </main>

  <aside>
    <h2>最近在读</h2>
    <ul>
      <li>《写给大家看的设计书》</li>
      <li>《CSS 世界》</li>
    </ul>
  </aside>

  <footer id="contact">
    <p>联系我:<a href="mailto:hello@example.com">hello@example.com</a></p>
    <p><small>© 2026 林小满 · 用热爱写成的页面</small></p>
  </footer>
</body>
</html>

自查清单

  • 是否只有一个 h1,标题层级有没有跳级?
  • 导航是否包在 nav 里,主内容是否在 main 里?
  • 每个 section 是否有标题,每个 article 是否可独立成立?
  • 图片是否写了 alt,链接文字是否有意义?
  • 有没有漏写 charset 与 viewport?
  • 在浏览器里打开,控制台是否零报错?

如果这张骨架已经写好,恭喜你——HTML 部分毕业了。 接下来打开 CSS 课程,我们要给这张素净的纸,上色、排版、添上光影。

结构是善意的开始:先让内容站对位置,再谈美。
—— 青禾手记