03 标题与段落¶
标题¶
用 # 表示标题,井号越多级别越低,最多六级:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
渲染效果:
一级标题¶
二级标题¶
三级标题¶
规则
#和文字之间必须有一个空格:# 标题✅,#标题❌(很多平台会当普通文字)。- 一篇文章只该有一个一级标题(通常是文章标题)。
- 不要跳级:从
##直接跳到####会让目录结构混乱。 - 想让标题显示成纯文字
#,前面加反斜杠转义:\# 不是标题。
另一种写法(很少用):在文字下面画横线
一级标题
=======
二级标题
-------
💡 实用建议:
===/---这种写法容易和正文的横线混淆,统一用#号就好。
段落¶
段落就是普通文本行。要点只有一条:
段落之间必须空一行(否则会被当成同一段,只是渲染时接在一起)。
这是第一段。
它和上一行属于同一段,渲染后还是一段。
这是第二段,因为前面有空行。
换行(最容易踩的坑)¶
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> |
| 加粗 | **文字** |
| 斜体 | *文字* |
| 删除线 | ~~文字~~ |
| 显示符号本身 | \符号 |
| 分隔线 | ---(前后空行) |
本章练习¶
- 写四个层级的标题,观察字号变化。
- 写两段话,中间不空行,看它们是否挤在一起;再空一行,看区别。
- 用
**、*、~~各写一个词,验证渲染效果。
下一章讲列表——写文档最常用的结构。