前言

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

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

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

标题

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

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

显示效果如下:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

字体

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

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

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


下划线

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

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

显示效果如下:

带下划线文本


列表

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

无序列表

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

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

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


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

显示结果如下:

  • 第一项
  • 第二项
  • 第三项
  • 第一项
  • 第二项
  • 第三项
  • 第一项
  • 第二项
  • 第三项

有序列表

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

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

显示效果如下:

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

列表嵌套

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

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

显示效果如下:

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

引用

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

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

显示效果如下:

这是引用的内容

这是引用的内容

这是引用的内容


分割线

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

1
2
3
4
---
----
***
*****

效果如下:





代码

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

1
`这是单行代码`

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

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

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

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

这是单行代码

代码块:

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

超链接

语法如下:

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

例如:

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

显示效果如下:

百度
Irving 的个人博客


表格

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

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

显示效果如下:

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

图片

语法如下:

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

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

例如:

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

显示效果如下:

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

小结

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

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