Markdown语法

145 阅读3分钟

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 表情符号