The silent page awaits the waking dawn.
<blockquote>
<p>读书不是为了雄辩和驳斥,也不是为了轻信和盲从,而是为了思考和权衡。</p>
</blockquote>
<p>——<cite>培根《随笔集》</cite></p>
<p>下次活动在 <time datetime="2026-12-05T14:00">12 月 5 日下午两点</time>,
地点在图书馆二楼阅览室。</p>
<p>练习:在终端执行 <code>git clone <仓库地址></code>,
然后按 <kbd>Ctrl</kbd> + <kbd>C</kbd> 退出。</p><h2>本期书单</h2>
<ul>
<li><cite>人类简史</cite>;尤瓦尔·赫拉利</li>
<li><cite>万历十五年</cite>;黄仁宇</li>
<li><cite>献给阿尔吉侬的花束</cite>;丹尼尔·凯斯</li>
</ul>
<ol start="2">
<li>安静阅读 30 分钟</li>
<li>轮流分享一个印象最深的段落</li>
</ol>
<nav aria-label="当前位置">
<ol>
<li><a href="/">首页</a></li>
<li><a href="/clubs/">读书会</a></li>
<li><a href="/clubs/weekend/">周末场</a></li>
</ol>
</nav><figure>
<picture>
<source srcset="venue-map.webp" type="image/webp">
<img src="venue-map.jpg"
alt="从图书馆正门进入,上二楼后右转到达阅览室"
width="800" height="450" loading="lazy" decoding="async">
</picture>
<figcaption>读书会会场路线图</figcaption>
</figure>
<video controls poster="club-cover.jpg" width="800">
<source src="recap.webm" type="video/webm">
你的浏览器不支持视频播放,<a href="recap.mp4">点此下载回放</a>。
</video><!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>周末读书会|活动安排与书单</title>
<meta name="description" content="每周六下午在城市图书馆二楼阅览室举办,现场提供阅读材料,欢迎带上正在读的书。">
<link rel="icon" href="/favicon.svg" type="image/svg+xml">
<link rel="canonical" href="https://example.com/clubs/weekend/">
<meta name="theme-color" content="#f5f1e8">
<meta property="og:type" content="website">
<meta property="og:title" content="周末读书会|活动安排与书单">
<meta property="og:description" content="每周六下午在城市图书馆二楼阅览室举办,现场提供阅读材料。">
<meta property="og:url" content="https://example.com/clubs/weekend/">
<meta property="og:image" content="https://example.com/img/club-cover.jpg">
<meta name="twitter:card" content="summary_large_image">
<link rel="stylesheet" href="style.css">
<script src="app.js" defer></script>
</head>
<body>
<!-- 上一课写好的 header、main、footer 放在这里 -->
</body>
</html>
HTML 常用标签与 Head 元数据:补全页面结构与文档信息
上一课用「周末读书会」页面搭起了骨架:doctype、html、head、body,一个 h1、一段文字,再加上语义分区和原生表单。骨架有了,问题才刚开始:书里的一段话怎么引用?一份书单用列表还是表格?活动时间要不要写成机器也能读的格式?这些属于「常用标签」。而 head 里除了 title 和 charset 还能写什么、写多长、按什么顺序写,属于「Head 元数据」。前者决定页面结构怎么搭,后者决定文档信息怎么描述。
读完后你会得到:一份「想表达什么 → 用哪个标签」的对照表;引用、代码、时间、术语表这些常被写错的写法;一个带 description、favicon、canonical 和分享卡片的 head;以及一份发布前逐条打勾的自查清单。示例仍是纯 HTML,双击文件就能看效果;涉及分享卡片和规范地址的几条要部署到真实域名才生效,文中会注明。
01|两类标签,两处位置
标签都在同一个文件里,但位置不同,职责也不同。可以先用一个问题把两者分开:这段东西是给读者看的,还是给浏览器、搜索引擎和分享平台看的?
位置
放什么
常见元素
head
描述文档本身:字符编码、标题、摘要、图标、规范地址、外部样式与脚本。内容不显示在正文里。
meta、title、link、script、style、base
body
描述文档内容:标题层级、段落、列表、引用、表格、图片和各种分区。这些是会显示出来的东西。
h1–h6、p、ul、ol、dl、blockquote、pre、figure、table、header、main、section、footer
还有一条容易被忽略的规则:head 里除 title 之外基本不产生可见内容;反过来,凡是能看见的东西都在 body 里。所以「把摘要塞进正文第一段」只是权宜之计——正文第一段是写给读者的,description 是写给搜索结果页的,两者可以不一样,也不必互相复制。
02|文本与短语:标题、段落、引用、代码
正文里最常写的还是文字。同样是几个字,标成不同元素,向浏览器和读屏软件传达的意思完全不同。
想表达什么
用哪个元素
注意
章节标题
h2 到 h6
按层级往下排,不要为了字号跳级;一个页面通常只有一个 h1。
一个段落
p
段间距用另一个 p 或 CSS 的 margin,不要用一串 br 顶出来。
确实需要换行
br
只在诗歌、地址、署名这类断行本身有意义的地方用。
话题转换
hr
表示段落级的话题切换,不是装饰用的分割线。
引用一整段话
blockquote,出处用 cite
出处的 cite 属性只接受 URL;书名、作者写在相邻段落或 figcaption 里。
引用一个短语
q
浏览器会自动加引号,别再手写一层引号包住它。
多行代码
pre 里套 code
pre 保留空格与换行,但内容里的 <、>、& 仍要转义。
行内代码、按键、输出、变量
code、kbd、samp、var
四个语义不同,不要一律用 code 代替。
重要性与语气强调
strong、em
b、i 只表示外观,不表示强调;纯样式交给 CSS。
与当前情境相关的高亮
mark
例如搜索命中的关键词,不要拿来当荧光笔随手涂。
细则、版权信息
small
表示边注类文字,不是「把字调小」的开关。
修改痕迹
del、ins、s
del 与 ins 表示删除和插入,s 只表示内容已不准确。
术语缩写
abbr 加 title
第一次出现时给出全称,后文就不必重复。
上下标、时间
sub、sup、time
time 的 datetime 用 ISO 格式,正文照常写自然语言。
time 的价值在于文本之外的机器可读版本:日历软件、搜索引擎和浏览器读的是 datetime 里的值,读者看到的仍是「12 月 5 日下午两点」。写成「下周六」这种相对说法时,过几天含义就变了。
代码块:pre 与 code 的分工
单独一个 code 只适合一小段代码;多行代码放进 pre,由它保留缩进和换行。注意 pre 内部仍按 HTML 解析:小于号要写成 <,与号要写成 &,否则页面上会凭空少一段文字。所以实际写作时通常是 pre 里套一个 code,语义和排版都正确。
03|列表与链接:条目、顺序与去向
读书会页面里天然有大量列表:书单、活动流程、注意事项。选 ul 还是 ol,只取决于顺序是否承载信息——「签到、阅读、分享」有先后,就是 ol;「三本推荐书」没有先后,就是 ul。
想表达什么
用哪个元素
注意
一组并列条目
ul 配 li
ul 与 ol 的直接子元素只能是 li,不能再塞 div。
有先后顺序的步骤
ol 配 li
需要时用 start、reversed 调整起点与方向,不要手写序号。
术语与解释
dl、dt、dd
也可以拿来排「书名+一句话简介」,比用一堆 p 更清楚。
站点导航
nav 配 ul 或 ol
页脚里一排友情链接不必用 nav;有多个导航时用 aria-label 起名。
跳到本页某处
a href="#schedule"
目标元素的 id 在同一页里不能重复,否则会跳到第一个同名元素。
外链在新标签页打开
target="_blank" 加 rel="noopener"
不加 rel 时,新页面可以通过 window.opener 影响原页面。
下载、邮件、电话
download、mailto:、tel:
写全地址与区号,别指望浏览器替你猜。
链接文字本身也有规范:写「查看活动流程」「下载书单 PDF」,而不是「点击这里」。读屏软件可以把页面所有链接列成一张表,文字含糊时用户没法判断会去向哪里。
上面三个片段分别演示了三件事:cite 标注作品名;start 让片段接在前一天的流程后面继续编号;面包屑用 nav 包一个有序列出层级。aria-label 是给辅助技术读的导航名称,页面同时有主导航和面包屑时,它能让两者区分开。
04|图片、图注与嵌入内容
想表达什么
用哪个元素
注意
展示一张图片
img
src 与 alt 必写;width、height 能减少加载时的布局跳动。
图片需要可见图注
figure 配 figcaption
figure 也能包代码块、引用、表格,只要它们需要一行说明。
按浏览器能力换格式
picture 配 source
最后一个 img 是必需的兜底,不能省。
视频、音频
video、audio
加 controls;视频用 poster 给封面,用 track 挂字幕。
嵌入外部页面
iframe
title 必写,否则读屏软件只说「框架」;按需加 loading="lazy" 与 sandbox。
两个细节值得记住。picture 不是为了显得新潮,只有确实需要按格式或屏幕条件换图时才用;一张图能解决就别加一层。视频标签之间的文字是兜底内容,浏览器不支持视频或用户禁用自动播放时会显示出来,所以那里要写一句有用的话,而不是留空。
05|表格与结构容器
表格只用于「按行列比较的数据」。报名名单、场地对比、书单评分是表格;页面排版不是。一旦用 table 排版,读屏软件会把整页当成数据来念。
元素
作用
caption
表格标题,读屏软件会先读它,比在表格上方另写一个 h3 更直接。
thead、tbody、tfoot
分出表头、主体与汇总行;长表格加上它们,样式和打印都更好控制。
th 加 scope
scope="col" 表示覆盖整列,scope="row" 表示覆盖整行,读屏时能念出对应的表头。
td
数据单元格。纯装饰的空白格留空即可,不要塞一个不分行的符号。
colspan、rowspan
合并单元格。合并之后每行的格子总数要数清楚,否则后面的列会整体错位。
结构容器负责给整页划大纲。读屏软件和搜索引擎可以按 h1、h2 和 section 的层级跳转,所以容器的选择不是审美问题。
容器
什么时候用
header
页面或某个分区的介绍:标题、标语、搜索框、主要导航。页头和每篇文章的题头都可以是 header。
nav
主要导航链接组。次要的一排外链不必用,用多了反而稀释它的意义。
main
页面独有的主要内容,一个页面只用一个,且不要嵌进 header、footer 或 article。
section
有主题的分区,通常配一个标题;写不出合适标题时,说明它可能只是一个 div。
article
能独立阅读或分发的内容:一篇文章、一张活动卡片、一条书评。判断标准是「单独拿出去还看得懂吗」。
aside
与主要内容相关但可以跳过的补充:相关链接、作者简介、往期活动。
footer
版权、联系方式、更新日期。页脚和文章末尾的标签列表都合适。
details、summary
原生折叠内容,默认收起,点击标题展开,不需要脚本。
一个实用做法:先给每一块内容拟一个 h2。拟得出来,这块就适合 section;拟不出来,它大概只是用来布局的 div。这个习惯能让大纲一直保持清楚,也让后面写 CSS 时知道该给谁加样式。
06|Head 元数据清单
head 里的东西读者看不见,却决定浏览器标签页、搜索结果、分享卡片、图标和资源加载。下面这份清单按「先编码、再身份、后增强」的顺序排列,写的时候照这个顺序往下填就不会乱。
元数据
典型写法
作用与注意
字符编码
<meta charset="utf-8">
必须出现在文件前 1024 字节内,并与文件实际保存的编码一致;放在一堆注释之后等于没写。
视口
<meta name="viewport" content="width=device-width, initial-scale=1">
让移动浏览器按设备宽度布局。不要加 user-scalable=no,那会禁止用户双指放大。
文档标题
<title>周末读书会|活动与书单</title>
显示在标签页、收藏夹和搜索结果。每页独立,页面名放前面、站点名放后面;约 30 个汉字以内比较稳。
摘要
<meta name="description" content="每周六下午在城市图书馆二楼阅览室举办,现场提供阅读材料。">
搜索结果摘要和部分分享文本。一到两句话,说清这页有什么;它不是排名开关,堆关键词只会让摘要更难看。
页面语言
<html lang="zh-CN">
写在 html 上,但同属文档信息:影响读屏发音、断词和翻译提示。
图标
<link rel="icon" href="/favicon.svg" type="image/svg+xml">
标签页图标。需要兼容旧设备时再补一张 png,手机主屏可用 apple-touch-icon。
规范地址
<link rel="canonical" href="https://example.com/clubs/weekend/">
同一内容能用多个地址访问时,指明首选那个;必须是完整 URL。
抓取指令
<meta name="robots" content="noindex, nofollow">
临时不希望被收录时用。正式页面上线前记得删掉,否则页面永远搜不到。
主题色
<meta name="theme-color" content="#f5f1e8">
移动浏览器地址栏与状态区的配色,可以随页面主题变。
分享卡片
<meta property="og:title" content="…">
常用 og:title、og:description、og:image、og:url、og:type。用 property 不是 name;og:image 要写绝对地址,常用约 1200×630。
X/Twitter 卡片
<meta name="twitter:card" content="summary_large_image">
多数平台会回落到 og,但重复写一份更稳,尤其是大图卡片。
资源提示
<link rel="preload" href="/fonts/serif.woff2" as="font" type="font/woff2" crossorigin>
只预加载首屏确实要用的资源。字体必须带 crossorigin,否则会重复下载一次。
样式表
<link rel="stylesheet" href="style.css">
放 head 里,避免首屏先闪一下无样式的文字。
脚本
<script src="app.js" defer></script>
defer 让脚本在文档解析完成后按顺序执行;type="module" 默认就是延迟执行。
结构化数据
<script type="application/ld+json">…</script>
用 JSON 描述活动、文章等信息,搜索引擎可据此生成更丰富的展示;JSON 里不能写注释。
基准地址
<base href="/clubs/">
会改变页面内所有相对链接和表单提交的解析结果。除非确有必要,一般不用。
这份清单不需要每页全抄。最小可用版本只有三项:charset、viewport、title。一个要对外分享的页面,再补 description、图标、canonical 和 og 四组;其余按实际需要增加,别为了让 head 看起来完整而堆进去。
07|Demo|补全读书会页面的 head
把上一课的骨架改写成下面这样,body 沿用原来的内容,这里用省略号占位。注意 canonical 和 og:url 写的是完整地址:分享平台不会拿你本地的相对路径去猜。
保存后刷新,标签页标题会变成「周末读书会|活动安排与书单」。如果本地还没有 favicon.svg,图标位置会显示浏览器默认图标,这是正常的。而 description、canonical 和 og 在本地完全看不出效果——它们要部署到真实域名之后,交给搜索引擎和分享平台去读。
08|顺序、长度与常见坑
09|发布前自查
接下来学什么
参考资料
查元素含义和嵌套规则看 MDN;需要确认规范原文时看 WHATWG;元数据字段的完整清单也在 MDN 的 head 条目里。
资料
适合查什么
MDN:HTML 元素参考
每个元素的含义、可用属性、允许的嵌套与浏览器兼容性。
MDN:head 元素
meta、link、title 的清单、写法与注意事项。
WHATWG:HTML 语义与 head
元素内容模型、文档元数据的定义与解析规则。
W3C WAI:Web 无障碍教程
表格表头、图片替代文本、导航与页面结构的无障碍实践。