前言

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档。

Markdown 能被使用来撰写电子书、博客等，当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如：GitHub、简书、Gitee 等。

本站的所有文章也是通过 Markdown 语法来写的。Markdown 语法虽然操作简单，但还是需要记一些语法，下面让我们来学习这些语法：

标题

使用 # 号可表示 1-6 级标题，一级标题对应一个#号，二级标题对应两个#号，以此类推。

1
2
3
4
5
6
7
CLEAN
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

显示效果如下：

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

字体

Markdown 可以使用以下几种字体：

1
2
3
4
5
MARKDOWN
*斜体文本*
**粗体文本**
***粗斜体文本***
~~这是加删除线的文字~~

显示效果如下：
斜体文本
粗体文本
*粗斜体文本*
这是加删除线的文字

下划线

下划线可以通过 HTML 的<u>标签来实现：

1
2
XML
<u>带下划线文本</u>

显示效果如下：

带下划线文本

列表

Markdown 支持有序列表和无序列表。

无序列表

无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记：

1
2
3
4
5
6
7
8
9
10
11
12
13
MARKDOWN
* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项


- 第一项
- 第二项
- 第三项

显示结果如下：

  • 第一项

  • 第二项

  • 第三项

  • 第一项

  • 第二项

  • 第三项

  • 第一项

  • 第二项

  • 第三项

有序列表

有序列表使用数字并加上 . 号来表示，如：

1
2
3
4
MARKDOWN
1. 第一项
2. 第二项
3. 第三项

显示效果如下：

  1. 第一项
  2. 第二项
  3. 第三项

列表嵌套

列表嵌套只需在子列表中的选项添加四个空格即可：

1
2
3
4
5
6
7
MARKDOWN
1. 第一项：
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项：
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第二个元素

显示效果如下：

  1. 第一项：
    • 第一项嵌套的第一个元素
    • 第一项嵌套的第二个元素
  2. 第二项：
    • 第二项嵌套的第一个元素
    • 第二项嵌套的第二个元素

引用

Markdown 引用是在段落开头使用>符号 ，然后后面紧跟一个空格符号，引用也可以嵌套，例如两个>>，三个>>>，以此类推：

1
2
3
4
SHELL
> 这是引用的内容
>> 这是引用的内容
>>> 这是引用的内容

显示效果如下：

这是引用的内容

这是引用的内容

这是引用的内容

分割线

分割线可以三个或三个以上的-或者*都可以：

1
2
3
4
5
ASCIIDOC
---
----
***
*****

效果如下：

代码

单行代码：代码之间分别用一个反引号包起来，例如：

1
2
ARCADE
`这是单行代码`

代码块：代码之间分别用三个反引号包起来，且两边的反引号单独占一行

1
2
3
4
5
6
AUTOHOTKEY
(```)
这是多行代码...
这是多行代码...
这是多行代码...
(```)

注：为了防止演示代码与撰写博客文章的 markdown 语法转译，我这里用括号将三个反引号隔开了，实际使用时去掉括号就行了。

显示效果如下：
单行代码：

1
这是单行代码

代码块：

1
2
3
4
ERLANG
这是多行代码...
这是多行代码...
这是多行代码...

超链接

语法如下：

1
2
3
DOS
[超链接名](超链接地址 "超链接title")
title可加可不加

例如：

1
2
3
AWK
[百度](http://baidu.com)
[Irving的个人博客](https://ouwen666.gitee.io "大爷，来玩啊！")

显示效果如下：

百度
Irving 的个人博客

表格

Markdown 制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行。
语法如下：

1
2
3
4
5
GHERKIN
|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

显示效果如下：

表头 表头
单元格 单元格
单元格 单元格

图片

语法如下：

1
2
3
4
5
PGSQL
![图片alt](图片地址 ''图片title'')

图片alt就是显示在图片下面的文字，相当于对图片内容的解释。
图片title是图片的标题，当鼠标移到图片上时显示的内容。title可加可不加

例如：

1
2
ARCADE
![Markdown](/images/md.jpg)

显示效果如下：
img

注：我这里图片是保存在本地的，所以图片地址哪里是本地目录，也可以用图片的在线链接地址

小结

此篇博客总结了我写 Hexo 博客常用的 Markdown 语法，如有不妥之处请查阅 MD 官方文档。

因为显示效果都是用 Markdown 语法呈现的，而我采用的主题又是通过文章的标题来显示文章目录，所以左侧的文章目录可能有点混乱···