标题
Markdown 有两种标题语法:
ATX 标题(推荐)
用 # 号前缀,数量决定层级(1-6 级):
源码
# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题
渲染效果
一级标题
二级标题
三级标题
INFO
# 后面必须有一个空格,#标题 不会被识别为标题(在 CommonMark 规范中)。习惯上每个文档只用一个 H1,用作文档标题。
Setext 标题(了解即可)
用下划线式标记,只支持 H1 和 H2:
一级标题 ======== 二级标题 --------
Setext 风格不推荐在新文档中使用,但阅读旧文档时可能遇到。
段落与换行
Markdown 中,连续的文本行(之间没有空行)会被合并成一个段落:
源码
这是第一段。 这行会和上面合并。 这是第二段(空行分隔)。
渲染效果
这是第一段。这行会和上面合并。
这是第二段(空行分隔)。
强制换行
在行末加两个空格,或使用 <br> 标签,可以强制换行(不开新段落):
第一行(行末有两个空格) 第二行(在同一段落内换行)
WARNING行末空格不可见,容易被编辑器自动删除。若需要换行,更推荐用
<br> 标签,或换一个新段落。
文本强调
加粗与斜体
源码
**这是加粗** *这是斜体* __这也是加粗__ _这也是斜体_ ***加粗斜体*** **加粗和*嵌套斜体***
渲染效果
这是加粗
这是斜体
加粗斜体
加粗和嵌套斜体
TIP推荐统一使用
**加粗** 和 *斜体*(星号风格),而不是下划线风格,因为下划线风格在单词内部可能产生歧义(如 foo_bar_baz)。
删除线(GFM 扩展)
源码
~~这段文字被删除~~
渲染效果
这段文字被删除
下划线与高亮
原生 Markdown 不支持下划线和文字高亮。可通过内嵌 HTML 实现:
<u>下划线文字</u> <mark>高亮文字</mark>
转义字符
用反斜杠 \ 可以让特殊字符失去 Markdown 含义,显示为字面量:
\*这段文字不会变成斜体\* \# 这行不会成为标题 \[这个方括号不会开始一个链接
可以转义的字符:
\ ` * _ { } [ ] ( ) # + - . ! |
HTML 实体
Markdown 支持 HTML 字符实体,常用于特殊符号:
| 实体 | 符号 | 用途 |
|---|---|---|
| & | & | & 符号 |
| < > | < > | 尖括号 |
| | (不换行空格) | 防止空格折叠 |
| © | © | 版权符号 |
| — | — | 破折号 |
小结
- ATX 标题(
#号前缀)是推荐写法,支持 1-6 级 - 空行分隔段落;行末两空格可强制换行(但不推荐)
**加粗**、*斜体*、~~删除线~~是最常用的文字格式- 反斜杠
\用于转义特殊字符