Skip to content

第 2 章:基础语法 ​

万丈高楼平地起。本章从最基础的语法开始,为你打开 Markdown 写作的大门。


学习目标 ​

  • 掌握 Markdown 标题的六级层级写法
  • 理解段落与换行的规则
  • 熟练使用粗体、斜体、删除线、高亮等文本格式
  • 理解「源码可读性」与「渲染效果」之间的关系

2.1 标题(Headings) ​

标题是文档的骨架。Markdown 使用 # 号来定义标题,数量代表层级:

markdown
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

渲染效果:

一级标题 ​

二级标题 ​

三级标题 ​

四级标题 ​

五级标题 ​
六级标题 ​

语法要点 ​

  1. # 和文字之间必须有一个空格,否则大部分解析器不识别:

    #正确    ← 错误:缺少空格
    # 正确   ← 正确
  2. 井号数量 = 层级,# 越多层级越低

  3. 只有六级标题(h1-h6),没有七级

  4. 还可使用底行式(Setext 风格),但只支持 h1 和 h2:

markdown
一级标题
=======

二级标题
-------

💡 实践建议:底行式写法较少使用,推荐统一使用井号式,风格一致且更直观。

标题层级的使用场景 ​

标题层级树状图

# 项目名称              ← h1:整个文档的标题,一个文件只有一个
## 大章节                ← h2:主要板块
### 小章节               ← h3:子话题
#### 细节说明            ← h4:深入展开

🔑 关键原则:一个 Markdown 文件中,有且仅有一个 # 一级标题。这有助于搜索引擎和工具正确提取文档标题。


2.2 段落与换行 ​

段落 ​

段落是 Markdown 最自然的单元:直接写文字,就是段落。

markdown
这是第一段。

这是第二段,中间有一个空行。

渲染效果:

这是第一段。

这是第二段,中间有一个空行。

规则:段落之间用一个空行(完全空白的行)分隔,就像写作时另起一段。

换行 ​

如果只想换行而不想新建段落(两个段落间距很大),有两种方式:

markdown
这是第一行␣␣   ← 行末加两个空格
这样就是换行而不是新段落。

这是第一行<br>  ← 或者使用 HTML 标签
这样也是换行。

💡 最佳实践:Markdown 中避免手动换行,让文本自然折行(软换行)。大多数情况下,一个句子一行是最清晰的写法——这被称为「按句换行」(Sentence-per-line),极利于版本控制。

对比总结 ​

写法渲染效果用途
文字中间换行(无空行无两空格)自动合并为同一段源码分行便于编辑
行末两空格 + 换行硬换行,间距小诗歌、地址
空行(两个段落间)新段落,间距大正常分段

2.3 文本格式 ​

粗体(Bold) ​

markdown
这是**粗体文字**,这也是__粗体文字__。

渲染:这是粗体文字,这也是粗体文字。

推荐使用 ** 而非 __,因为 ** 在单词中间也有效:un**believ**able → unbelievable。

斜体(Italic) ​

markdown
这是*斜体文字*,这也是_斜体文字_。

渲染:这是斜体文字,这也是斜体文字。

推荐使用 * 而非 _,原因同上。

粗斜体 ​

markdown
这是***粗斜体文字***,这也是___粗斜体文字___。

渲染:这是粗斜体文字。

删除线(Strikethrough) ​

markdown
这段文字包含~~删除内容~~。

渲染:这段文字包含删除内容。

常用于文档修订、任务回顾等场景,表达「这个内容曾经有效但现在已被废弃」。

高亮(Highlight) ​

markdown
这是==高亮文字==。

渲染:这是==高亮文字==。

⚠️ 兼容性提示:高亮是较新的扩展语法。GitHub 目前不原生支持(在 GitHub 上显示为普通文本),但 Typora、Obsidian、Notion、飞书等编辑器支持。如需在 GitHub 上实现高亮效果,可使用 HTML 的 <mark> 标签:

html
<mark>高亮文字</mark>

2.4 文本格式的组合 ​

多个格式可以组合使用:

markdown
这是**粗体中带*斜体*的文字**。
这是***粗斜体~~带删除线~~***。
这也是**粗体加==高亮==**(高亮取决于平台支持)。

渲染:这是粗体中带斜体的文字。这是粗斜体带删除线。

格式嵌套顺序 ​

格式符号的书写顺序不影响渲染结果,但遵循一致的顺序有助于源码可读性:

**粗体** **==高亮==** ~~删除线~~ ***粗斜体***

2.5 语法速查 ​

语法写法说明
一级标题# 标题文档主标题,一个文件只有一个
二级标题## 标题主要章节
三级标题### 标题小节
段落空行分隔段落间留一个空行
换行行末两空格或 <br>不推荐频繁使用
粗体**文字**推荐双星号
斜体*文字*推荐单星号
粗斜体***文字***三重星号
删除线~~文字~~GFM 扩展
高亮==文字==部分平台支持

本章小结 ​

要点说明
标题# 号个数 = 层级,共六级,一个文件只有一个 h1
段落空行分隔,同一段落内自动折行
粗体/斜体推荐用星号 **粗体**、*斜体*
删除线~~删除文字~~,表达废弃内容
高亮==高亮文字==,注意目标平台的兼容性
格式组合嵌套格式遵循直觉,正常书写即可

下一章预告 ​

掌握了文本格式,接下来学习如何组织多个条目——列表。包括无序列表、有序列表和超实用的任务列表。

👉 第 3 章:列表

📖本文阅读--次|📊全站访问--次|👥访客--人