跳转至

03 标题与段落

标题

用 # 表示标题,井号越多级别越低,最多六级:

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

渲染效果:

一级标题

二级标题

三级标题

规则

  1. # 和文字之间必须有一个空格:# 标题 ✅,#标题 ❌(很多平台会当普通文字)。
  2. 一篇文章只该有一个一级标题(通常是文章标题)。
  3. 不要跳级:从 ## 直接跳到 #### 会让目录结构混乱。
  4. 想让标题显示成纯文字 #,前面加反斜杠转义:\# 不是标题。

另一种写法(很少用):在文字下面画横线

一级标题
=======

二级标题
-------

💡 实用建议:=== / --- 这种写法容易和正文的横线混淆,统一用 # 号就好。

段落

段落就是普通文本行。要点只有一条:

段落之间必须空一行(否则会被当成同一段,只是渲染时接在一起)。

这是第一段。
它和上一行属于同一段,渲染后还是一段。

这是第二段,因为前面有空行。

换行(最容易踩的坑)

Markdown 里单个回车不等于换行,它只是一个空格。想换行有两种办法:

方法 写法 说明
行尾两个空格 文字 + 空格 + 空格 + 回车 标准做法,但空格看不见,容易漏
反斜杠换行 文字\ + 回车 部分解析器支持(GFM 支持)
插一个空行 文字 + 空行 + 文字 变成两个段落,间距更大
用 HTML 文字<br> 万能,任何解析器都认

推荐:想让两行紧贴(比如地址、诗句),用 <br>;想要段落效果,直接空一行。

⚠️ 在 VS Code 里可以打开 markdown.preview.breaks,让单个回车就换行——但注意别的平台不认这个设置,文档发给别人可能还是会挤在一起。所以重要文档别偷懒。

强调:粗体 / 斜体 / 删除线

效果 写法 快捷键(VS Code / Typora)
斜体 *文字* 或 _文字_ Ctrl + I
粗体 **文字** 或 __文字__ Ctrl + B
粗斜体 ***文字*** —
~~删除线~~ ~~文字~~ —
高亮 ==文字== 部分平台支持(Obsidian、MkDocs)

规则

  • 符号和文字之间不要加空格:** 粗体 ** 会渲染失败。
  • 中文里用 * 更稳:_下划线_ 在句子中间遇到英文单词可能不生效(如 snake_case_name)。
  • 下划线写法在词中会被忽略:foo_bar_baz 不会变成斜体。

转义:想显示符号本身

在这些符号前加反斜杠 \,就能让它变回普通字符:

\   反斜杠
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  圆括号
#   井号
+   加号
-   减号
.   英文句点
!   感叹号
|   竖线

例:\*这不是斜体\* → *这不是斜体*

分隔线

单独一行写 三个或以上 的 -、*、_(中间可有空格):

---
***
___

效果:


⚠️ 别把 --- 紧贴在文字下面写,它会把上一行变成二级标题(同前面说的横线标题写法)。前后要空行。

行内标记速览(本节小结)

你想要的 写法
大标题 / 小标题 # 到 ######
新段落 中间空一行
强制换行 行尾 <br>
加粗 **文字**
斜体 *文字*
删除线 ~~文字~~
显示符号本身 \符号
分隔线 ---(前后空行)

本章练习

  1. 写四个层级的标题,观察字号变化。
  2. 写两段话,中间不空行,看它们是否挤在一起;再空一行,看区别。
  3. 用 **、*、~~ 各写一个词,验证渲染效果。

下一章讲列表——写文档最常用的结构。