第 2 章:基础语法
万丈高楼平地起。本章从最基础的语法开始,为你打开 Markdown 写作的大门。
学习目标
- 掌握 Markdown 标题的六级层级写法
- 理解段落与换行的规则
- 熟练使用粗体、斜体、删除线、高亮等文本格式
- 理解「源码可读性」与「渲染效果」之间的关系
2.1 标题(Headings)
标题是文档的骨架。Markdown 使用 # 号来定义标题,数量代表层级:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题渲染效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
语法要点
#和文字之间必须有一个空格,否则大部分解析器不识别:#正确 ← 错误:缺少空格 # 正确 ← 正确井号数量 = 层级,
#越多层级越低只有六级标题(h1-h6),没有七级
还可使用底行式(Setext 风格),但只支持 h1 和 h2:
一级标题
=======
二级标题
-------💡 实践建议:底行式写法较少使用,推荐统一使用井号式,风格一致且更直观。
标题层级的使用场景
# 项目名称 ← h1:整个文档的标题,一个文件只有一个
## 大章节 ← h2:主要板块
### 小章节 ← h3:子话题
#### 细节说明 ← h4:深入展开🔑 关键原则:一个 Markdown 文件中,有且仅有一个
#一级标题。这有助于搜索引擎和工具正确提取文档标题。
2.2 段落与换行
段落
段落是 Markdown 最自然的单元:直接写文字,就是段落。
这是第一段。
这是第二段,中间有一个空行。渲染效果:
这是第一段。
这是第二段,中间有一个空行。
规则:段落之间用一个空行(完全空白的行)分隔,就像写作时另起一段。
换行
如果只想换行而不想新建段落(两个段落间距很大),有两种方式:
这是第一行␣␣ ← 行末加两个空格
这样就是换行而不是新段落。
这是第一行<br> ← 或者使用 HTML 标签
这样也是换行。💡 最佳实践:Markdown 中避免手动换行,让文本自然折行(软换行)。大多数情况下,一个句子一行是最清晰的写法——这被称为「按句换行」(Sentence-per-line),极利于版本控制。
对比总结
| 写法 | 渲染效果 | 用途 |
|---|---|---|
| 文字中间换行(无空行无两空格) | 自动合并为同一段 | 源码分行便于编辑 |
| 行末两空格 + 换行 | 硬换行,间距小 | 诗歌、地址 |
| 空行(两个段落间) | 新段落,间距大 | 正常分段 |
2.3 文本格式
粗体(Bold)
这是**粗体文字**,这也是__粗体文字__。渲染:这是粗体文字,这也是粗体文字。
推荐使用 ** 而非 __,因为 ** 在单词中间也有效:un**believ**able → unbelievable。
斜体(Italic)
这是*斜体文字*,这也是_斜体文字_。渲染:这是斜体文字,这也是斜体文字。
推荐使用 * 而非 _,原因同上。
粗斜体
这是***粗斜体文字***,这也是___粗斜体文字___。渲染:这是粗斜体文字。
删除线(Strikethrough)
这段文字包含~~删除内容~~。渲染:这段文字包含
删除内容。
常用于文档修订、任务回顾等场景,表达「这个内容曾经有效但现在已被废弃」。
高亮(Highlight)
这是==高亮文字==。渲染:这是==高亮文字==。
⚠️ 兼容性提示:高亮是较新的扩展语法。GitHub 目前不原生支持(在 GitHub 上显示为普通文本),但 Typora、Obsidian、Notion、飞书等编辑器支持。如需在 GitHub 上实现高亮效果,可使用 HTML 的
<mark>标签:html<mark>高亮文字</mark>
2.4 文本格式的组合
多个格式可以组合使用:
这是**粗体中带*斜体*的文字**。
这是***粗斜体~~带删除线~~***。
这也是**粗体加==高亮==**(高亮取决于平台支持)。渲染:这是粗体中带斜体的文字。这是粗斜体
带删除线。
格式嵌套顺序
格式符号的书写顺序不影响渲染结果,但遵循一致的顺序有助于源码可读性:
**粗体** **==高亮==** ~~删除线~~ ***粗斜体***2.5 语法速查
| 语法 | 写法 | 说明 |
|---|---|---|
| 一级标题 | # 标题 | 文档主标题,一个文件只有一个 |
| 二级标题 | ## 标题 | 主要章节 |
| 三级标题 | ### 标题 | 小节 |
| 段落 | 空行分隔 | 段落间留一个空行 |
| 换行 | 行末两空格或 <br> | 不推荐频繁使用 |
| 粗体 | **文字** | 推荐双星号 |
| 斜体 | *文字* | 推荐单星号 |
| 粗斜体 | ***文字*** | 三重星号 |
| 删除线 | ~~文字~~ | GFM 扩展 |
| 高亮 | ==文字== | 部分平台支持 |
本章小结
| 要点 | 说明 |
|---|---|
| 标题 | # 号个数 = 层级,共六级,一个文件只有一个 h1 |
| 段落 | 空行分隔,同一段落内自动折行 |
| 粗体/斜体 | 推荐用星号 **粗体**、*斜体* |
| 删除线 | ~~删除文字~~,表达废弃内容 |
| 高亮 | ==高亮文字==,注意目标平台的兼容性 |
| 格式组合 | 嵌套格式遵循直觉,正常书写即可 |
下一章预告
掌握了文本格式,接下来学习如何组织多个条目——列表。包括无序列表、有序列表和超实用的任务列表。
👉 第 3 章:列表