Markdown 语法
记录一下 Markdown 语法,罗列出来的不是最全的,但是都是最推荐使用的。大部分内容来自书籍《了不起的Markdown》
1 基础语法
1.1 标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
标题使用 “# + 空格(space)+ 文字” 的形式,最多支持六级标题
1.2 粗体和斜体
**粗体** *斜体*
粗体使用两个星号(*)包裹
斜体使用一个星号包裹
1.3 换行
两个空格加一个回车(enter)形成一个换行,单独一个回车不会换行
1.4 列表
1.4.1 有序列表
1. 列表项 2. 列表项
有序列表使用 “数字 + 英文点 + 空格 + 文字” 的形式
1.4.2 无序列表
- 列表项 - 列表项
有序列表使用 “减号(-) + 空格 + 文字” 的形式
1.4.3 嵌套列表
1. 列表项 1. 列表项 2. 列表项 2. 列表项 1. 列表项 2. 列表项
有序列表和无序列表都支持嵌套,在子列表前加制表键(tab)即可
1.5 分割线
******
分割线可以使用连续3个或者3个以上星号形成
1.6 图片

图片地址支持相对路径和绝对路径,建议使用绝对路径
1.7 链接
1.7.1 文字链接
[链接文字](链接地址)
1.7.2 引用链接
[链接文字][链接tag] [链接tag]:链接地址
1.7.3 网址链接
<URL 或邮箱地址>
1.8 代码
1.8.1 行内代码
`行内代码`
行内代码用一组反引号(`)包裹
1.8.2 代码块
ll | wc -l
```bash
ll | wc -l
```
代码块可以用 “ 制表键 + 代码 ” 组成,也可以用三个反引号 (```) 包裹;更建议使用后者,反引号需要另起行,第一个反引号后可以指明(例如bash)语言来提供关键字高亮
1.9 引用
> 引用内容
引用以大于号(>)开头,建议在大于号和引用内容间加入一个空格
1.10 转义
可以转义的特殊符号如下:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句号
! 感叹号
转义语法如下:
\特殊符号
2 扩展语法GFM
GFM(GitHub Flavored Markdown)是最流行的 Markdown 扩展语法
2.1 删除线
~~删除~~
效果如下:
删除
删除内容由两个波浪线包裹
2.2 表情符号
表情符号使用格式
:smile: :laughing: :+1: :-1:
效果如下:
:smile:
:laughing:
:+1:
:-1:
更多表情符号请参考 www.webfx.com/tools/emoji…
2.3 自动链接
在标准语法中,由 <> 包裹的 URL 地址可以被识别位超链接,在GFM语法中可以不用 <> 包裹,但是这只支持以 www 和 http/https 开头的地址;建议链接地址使用标准语法
2.4 表格
| 默认表头 | 居中对齐 | 靠右对齐 | | -------- | :------: | -------: | | 内容1 | 内容2 | 内容3 | | 内容1 | 内容2 | 内容3 |
以下是效果:
| 默认表头 | 居中对齐 | 靠右对齐 |
|---|---|---|
| 内容1 | 内容2 | 内容3 |
| 内容1 | 内容2 | 内容3 |
- 左对齐(默认):--
- 右对齐 --:
- 居中对齐 :--:
2.5 任务列表
- [ ] 未勾选 - [x]已勾选
效果如下:
- 未勾选
- 已勾选
2.6 围栏代码块
```bash ll | wc -l ```
~~~bash
ll | wc -l
~~~
代码块可以用 ~~~ 或者 ``` 包裹,建议使用 ```
2.7 锚点
锚点语法如下:
[锚点描述](#锚点名字)
例子如下: 2.2 表情符号