前言

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，Markdown 文件的后缀名便是“.md”。
Markdown 常被使用来撰写电子书、博客等，同时也是我们用来记笔记的好伙伴。

本文主要介绍 Markdown 基本语法，如标题、代码块、列表、引用等语法的使用规则。

一、标题语法

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

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

效果展示：

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

注：# 和文字之间的空格（以及其他语法中的空格）

二、代码语法

要将单词或短语表示为代码，请将其包裹在反引号( ` )中。

1
这是`Markdown`语法

效果展示：

这是Markdown语法

代码块：使用( ``` )包裹中代码即可
效果展示：

1
这是代码块

三、字体语法

Markdown 可以使用以下几种字体

1
2
3
4
5
*斜体文本*
**粗体文本**
***粗斜体文本***
~~这是加删除线的文字~~
<u>带下划线文本</u>

效果展示：

斜体文本
粗体文本
粗斜体文本
这是加删除线的文字
带下划线文本

四、表格语法

使用三个或多个连字符- - -创建每列的标题，并使用管道|分隔每列。

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

效果展示：

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

对齐：在标题行中的连字符使用:，来控制表格的文本对齐方式

1
2
3
4
| Syntax      | Description | Test Text     |
| :---        |    :----:   |          ---: |
| Header      | Title       | Here's this   |
| Paragraph   | Text        | And more      |

效果展示：

Syntax Description Test Text
Header Title Here’s this
Paragraph Text And more

五、列表语法

有序列表

在每个列表项前添加数字并紧跟一个英文句点.，列表应当以数字 1 起始。

1
2
1. 第一行
2. 第二行

效果展示：

  1. 第一行
  2. 第二行

无序列表

在每个列表项前面添加破折号-、星号*或加号+。缩进一个或多个列表项可创建嵌套列表。

1
2
- First item
- Second item

效果展示：

  • First item
  • Second item

列表嵌套

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

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

效果展示：

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

六、文本语法

引用

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

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

效果展示：

这是引用的内容

这是引用的内容

这是引用的内容

超链接

语法如下：

1
2
3
[超链接名](超链接地址 "超链接title")，title则是鼠标放上去悬浮显示的文本。
[百度](https:www.//baidu.com)
[默谐的个人博客](https://githubmoxie.github.io/ "欢迎来到我的博客！")

效果展示：
百度
默谐的个人博客

图片

使用感叹号![](), 其中[]增加替代文本，()放图片链接。

1
2
3
4
5
6
![图片alt](图片链接 "图片title")
注：图片alt为图片加载错误出现的文本,点击查看后图片下方也会出现文本
![clannad](https://pic.imgdb.cn/item/61bb54112ab3f51d91ff7d77.jpg)

使用img标签可以控制图片大小
<img src="图片地址" alt="图片替换文本" width="500" height="300" />

效果展示：

clannad

分割线

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

1
2
---
***

效果展示：

七、扩展用法

Markdown 文档上下跳转

使用<div id="skip"></div>的id属性，再使用[跳转文本](#id名称)来跳转。

1
2
3
<div id="skip"></div>
将<div id="skip"></div>放在前言的上方，即瞄点位置。
[跳转到前言](#skip)

效果展示：
跳转到前言

注：在Hexo中跳转，可参考：
Hexo文档中的跳转

换行符

使用标签<br/>

1
这是第一行文字<br/>这是换行后的文字

效果展示：
这是第一行文字
这是换行后的文字

其他

Markdown 语法编辑器推荐Typora

该编辑器直接使用鼠标右键就可快速使用 Markdown 语法，方面文档的撰写！。

官方地址：Typora

参考

Markdown 官方教程