第一章 · 入门
基础语法:从第一行 DOCTYPE 开始
在学会任何框架之前,先把 HTML 本身读透。这一章从「它到底是什么」讲起, 拆开一个最小页面,再逐层认识元素、属性、标题、段落与文本语义。 每一个概念后面都跟着可以直接运行的代码。
HTML 到底是什么
HTML 的全称是 HyperText Markup Language,中文译为「超文本标记语言」。 拆开来看:超文本指页面之间可以通过链接互相跳转,标记指用一对对标签把内容「圈」起来, 说明「这是一段标题」「这是一张图片」「这是一个按钮」。
它不是编程语言:没有变量、循环和条件判断,也不负责计算。 它更像一份结构说明书——告诉浏览器每块内容是什么、彼此是什么关系。 真正让它变好看的是 CSS,让它能动起来的是 JavaScript。
| 技术 | 职责 | 类比 |
|---|---|---|
| HTML | 结构与语义:标题、段落、列表、表单、图片 | 房子的墙体与房间划分 |
| CSS | 表现与布局:颜色、字体、间距、响应式 | 墙漆、地板与家具摆放 |
| JavaScript | 行为与交互:点击、请求、动画、状态 | 电路、开关与智能家居 |
浏览器拿到 HTML 后,会依次做这些事:下载字节 → 按编码解码成字符 → 词法分析成一个个标签 → 构建 DOM 树(文档对象模型)→ 结合 CSS 计算样式 → 布局 → 绘制到屏幕。 你写的每一个标签,最后都会变成 DOM 树上的一个节点。理解这一点,后面的语义化、可访问性、SEO 都会顺理成章。
<p>你好,世界。这是你的第一段 HTML。</p>
点击代码卡右上角的「运行预览」,就能看到这段代码在浏览器里的真实效果。本章所有带预览按钮的示例都可以这样玩。
一个最小可用的文档骨架
单独的片段可以渲染,但一个完整的网页应该有固定的骨架。下面这份模板可以直接保存成
index.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>你好,HTML</h1>
<p>这是一段普通的文字。</p>
</body>
</html>
lang 声明页面语言,影响屏幕阅读器发音、浏览器翻译提示、断词与搜索引擎判断,别省略。width=device-width 让页面宽度等于设备宽度,initial-scale=1.0 设定初始缩放比例。没有它,手机浏览器会按 980px 的虚拟宽度缩放页面。<body>。文件保存时选择 UTF-8 编码、后缀用 .html;文件名尽量用英文小写加连字符(如 my-first-page.html),避免空格和中文,部署到服务器时更省心。
元素、标签与属性
一个完整的元素通常由开始标签、内容、结束标签组成。属性写在开始标签里, 用「名="值"」的形式提供额外信息。以一段链接为例:
<a href="https://example.com" target="_blank">去逛逛</a>
<!-- a 元素名(标签名)
href 属性名
"..." 属性值
去逛逛 元素内容
</a> 结束标签 -->
空元素:没有内容,也没有结束标签
有些元素天生不包裹内容,称为空元素(void elements)。它们只有开始标签,
不需要写 </br> 之类。常见的有:
在 HTML5 中,<br> 和 <br /> 都能工作,但斜杠只是历史遗留的兼容写法,
现代写法推荐直接使用 <br>。
布尔属性:出现即为真
像 disabled、required、checked、hidden 这类属性,
只要写在标签里就表示「开启」,不需要写值。写成 disabled="" 或 disabled="disabled" 也合法,
但最简洁、最推荐的写法就是只写属性名。
<!-- 三种写法等价,推荐第一种 -->
<input type="text" disabled>
<input type="text" disabled="">
<input type="text" disabled="disabled">
属性值的书写习惯
- 值一律用双引号包裹;值内部含双引号时用单引号,或把内部双引号写成
"。 - 属性名与标签名习惯全小写。HTML 本身不区分大小写,但小写更易读,也是社区共识。
- 属性之间用空格分隔,等号两侧通常不留空格。
- 自定义数据用
data-*,例如data-id="42",JS 中可通过dataset.id读取。
嵌套:标签必须像盒子一样套好
元素可以嵌套,但不能交叉。正确的嵌套是「完全包含」,错误的写法会被浏览器自作主张地修补, 导致 DOM 结构和你想的不一样。
<!-- 错误:交叉嵌套,浏览器会拆开修复 -->
<p>一段 <strong>重点文字</p></strong>
<!-- 正确:成对包裹 -->
<p>一段 <strong>重点文字</strong></p>
<!-- 错误:p 里不能放块级元素,浏览器会自动提前结束段落 -->
<p>文字 <div>盒子</div></p>
<!-- 正确:需要块级容器,就把 p 换成 div,或把 div 放到 p 外面 -->
<div>文字 <div>盒子</div></div>
浏览器非常宽容,写错也能显示,但它修复后的结构和你的预期往往不同,后续 CSS、JS、SEO 都会受影响。写完用 W3C 校验器过一遍,是很好的习惯。
注释、空白与大小写
注释写在 <!-- 与 --> 之间,不会显示在页面上,也不会被 CSS 或 JS 执行。
它适合解释「为什么这样做」,或者临时屏蔽一段代码。
<!-- 这是一个单行注释 -->
<!--
注释可以跨行。
但注释不能嵌套:里面再出现 <!-- 会提前结束或造成混乱。
-->
<!-- 注释不能塞在标签内部 -->
<!-- 错误示范:<p <!-- 注释 --> class="x">内容</p> -->
空白会被折叠
在 HTML 中,连续的空格、换行、制表符会折叠成一个空格;元素开头和结尾的空白会被忽略。 所以你在源码里怎么缩进、怎么换行,都不会影响页面的排版。
需要保留原始空白时,用 <pre> 元素(预格式化文本),它常用于展示代码、诗歌或 ASCII 图。
也可以用 CSS 的 white-space 属性控制。
<p>这里 有 很多空格,
但浏览器只显示一个。</p>
<pre>
山 静 而 风 止
水 流 而 日 长
</pre>
不换行空格 常被用来「撑开距离」,但它属于内容而非样式。需要间距时优先用 CSS 的 margin / padding,否则复制文本、屏幕阅读器朗读都会受到干扰。
大小写与闭合
HTML 标签名和属性名不区分大小写,<DIV> 与 <div> 等价,
统一小写是业界习惯。HTML 也不要求空元素自闭合。需要注意的是:如果你未来接触 JSX / Vue 模板,
大小写和闭合规则会严格得多,从 HTML 阶段就养成小写、成对的习惯,迁移成本最低。
标题与段落
<h1> 到 <h6> 表示六级标题,数字越小层级越高。
标题不是「大号加粗文字」,而是文档的结构骨架:屏幕阅读器会按标题跳读,
搜索引擎会据此理解页面主题,浏览器插件也会据此生成目录。
<h1>山间笔记</h1>
<p>把日子过慢一点,才看得见光。</p>
<h2>一、清晨</h2>
<p>雾还没有散,石阶上有昨夜留下的水痕。</p>
<h2>二、午后</h2>
<p>阳光从树叶的缝隙里漏下来,落在书页上。</p>
<h3>2.1 一杯茶的时间</h3>
<p>水汽升起来,字也慢了下来。</p>
使用时记住几条原则:
- 一个页面通常只有一个
<h1>,用来说明页面主题,通常与<title>呼应但不完全相同。 - 不要跳级:从
h2直接到h4会破坏大纲,应该逐级递进。 - 标题要有内容:避免「更多」「点击这里」这种无信息量的标题。
- 不要为了字号选标签:想让字变大变小,用 CSS 的
font-size,而不是换h标签。
段落、换行与分隔线
<p> 表示一个段落,自带上下间距的语义。<br> 表示文本内部的强制换行,
适合地址、诗歌这类「同一段内的换行」;<hr> 表示主题性的分隔(比如场景切换),
不是「画一条线」的装饰。
<p>
收件人:林小明<br>
地址:杭州市西湖区某某路 12 号<br>
电话:138-0000-0000
</p>
<hr>
<p>后来,那家书店搬走了。</p>
用连续的 <br><br><br> 制造段落间距。间距是表现层的职责,交给 CSS 的 margin,HTML 只负责「这是一个新段落」。
文本级语义:让字句自己说话
除了标题和段落,HTML 还提供了大量行内语义元素,用来描述一小段文字的性质。 它们的默认样式可能只是加粗或倾斜,但真正的价值在于「意思」——机器能读懂,辅助技术能读懂。
| 元素 | 含义 | 典型场景 |
|---|---|---|
<strong> | 重要、紧急,语气强 | 警告、关键结论 |
<em> | 重读、强调语气 | 「我真的不知道」 |
<b> / <i> | 仅视觉加粗 / 斜体,无语义或外文、术语 | 产品名、拉丁学名 |
<mark> | 与当前语境相关的标记 | 搜索结果高亮 |
<small> | 旁注、法律声明等小字 | 版权、免责声明 |
<del> / <ins> | 已删除 / 已插入的内容 | 价格调整、修订记录 |
<s> | 不再准确或不再相关 | 过期原价 |
<code> | 代码片段 | 函数名、标签名 |
<kbd> | 键盘输入 | 快捷键 |
<samp> | 程序输出 | 报错信息 |
<var> | 变量名 | 公式中的 x |
<abbr> | 缩写,title 给出全称 | HTML、API |
<cite> | 作品名(书名、文章名) | 《小王子》 |
<q> | 短引用,浏览器自动加引号 | 一句话引用 |
<blockquote> | 块级引用,可配 cite 属性 | 整段摘录 |
<time> | 日期时间,datetime 提供机器格式 | 发布时间、活动时间 |
<bdi> / <bdo> | 文本方向隔离 / 强制方向 | 多语言用户名、阿拉伯语 |
<wbr> | 可换行点 | 长 URL、长单词 |
<ruby> | 注音标注 | 日语假名、中文拼音 |
<p>读到 <strong>关键处</strong> 要用力,<em>语气</em> 可以轻一点。</p>
<p>原价 <del>¥199</del>,现价 <ins>¥99</ins>;<mark>限时三天</mark>。</p>
<p>按 <kbd>Ctrl</kbd> + <kbd>S</kbd> 保存,代码写作 <code><main></code>。</p>
<p><abbr title="HyperText Markup Language">HTML</abbr>
是网页的骨架。</p>
<p>会议定在
<time datetime="2026-12-01T09:30">12 月 1 日上午九点半</time>。
</p>
<blockquote cite="https://www.w3.org/TR/html52/">
<p>标记语言的价值,在于让内容自己说明自己。</p>
</blockquote>
<p>—— 摘自 <cite>HTML 规范</cite></p>
还有一个很实用的小元素:<ruby>,用于给文字加注音。
配合 <rt>(读音)与 <rp>(不支持时的括号回退)使用。
<p>
<ruby>汉<rp>(</rp><rt>hàn</rt><rp>)</rp></ruby>
<ruby>字<rp>(</rp><rt>zì</rt><rp>)</rp></ruby>
<ruby>之<rp>(</rp><rt>zhī</rt><rp>)</rp></ruby>
<ruby>美<rp>(</rp><rt>měi</rt><rp>)</rp></ruby>
</p>
问自己一句:「如果去掉加粗/斜体,这句话的意思会变吗?」会变,用 <strong> / <em>;只是排版好看,用 <b> / <i>,或者干脆交给 CSS。语义优先,样式其次。
字符实体与转义
有两个字符在 HTML 里具有特殊含义:< 表示标签开始,& 表示实体开始。
如果你想在页面上显示它们本身,就必须写成「字符实体」。
| 实体 | 显示为 | 说明 |
|---|---|---|
< | < | 小于号,标签左尖括号 |
> | > | 大于号 |
& | & | 和号 |
" | " | 双引号 |
' | ' | 单引号 |
| 不换行空格 | |
© | © | 版权符号 |
— | — | 长破折号 |
… | … | 省略号 |
× | × | 乘号 |
→ | → | 右箭头 |
© / © | © | 数字实体,十进制 / 十六进制 |
<!-- 想在页面上显示标签本身,就要转义尖括号 -->
<p>段落标签这样写:<p>内容</p></p>
<!-- 版权、破折号、省略号 -->
<p>© 2026 — 拾光 HTML …</p>
<!-- 属性值里出现双引号 -->
<p title="他说:"慢一点"">把鼠标放上来看看</p>
实体以分号结尾,别漏写;& 经常被误写成 &,导致后面的内容被当成实体解析。URL 中的 & 也建议写成 &(HTML 属性内)。
初学者最容易踩的十个坑
- 用 <div> 包一切。标题、段落、列表、按钮都有专属标签,先问「它是什么」,再决定用什么。
- 图片没有 alt。装饰性图片写
alt="",有内容的图片写清楚描述。 - 标题层级混乱。一个页面多个
h1、从h2跳到h5,都会破坏大纲。 - 用 <br> 造间距。间距交给 CSS,
br只负责「同一段内换行」。 - 用 <b> 代替所有加粗。语义上该用
strong的地方,别用b。 - 链接嵌套链接。
a里再放a或button,属于交互内容嵌套,行为不可预期。 - 忘记 lang。屏幕阅读器会用错误的语言发音。
- 忘记 charset。中文乱码十有八九是编码声明缺失或文件不是 UTF-8。
- 用表格做布局。表格只用于表格数据;布局用 CSS Grid / Flexbox。
- 代码里的 < > & 不转义。浏览器会把它们当成标签或实体,页面结构直接崩掉。
小结与练习
这一章你认识了 HTML 的定位、最小文档骨架、元素与属性的写法、注释与空白规则、 标题与段落的层级,以及常用的行内语义元素和字符实体。它们是后面所有章节的地基。
三个小练习
- 不看上面的模板,手写一份包含
doctype、html、head、body的完整页面,标题写你的名字。 - 用
h1–h3、p、strong、em、time写一篇 150 字的日记,要求层级正确。 - 在页面上显示这样一行文字:
<p> 是段落标签 & 它很重要(提示:需要转义)。
有了骨架,接下来往里填内容:链接怎么指向别处、图片怎么适配屏幕、列表与表格怎么组织数据。继续读第二章。