简介

Markdown 是一种纯文本格式的标记语言。通过简单的标记语法，它可以使普通文本内容具有一定的格式。在 2004 由约翰·格鲁伯（英语：John Gruber）创建。编写的文档后缀为 .md, .markdown。

一、标题

在想要设置为标题的文字前面加 #来表示，一个#是一级标题，二个#是二级标题，以此类推。支持六级标题。
注：标准语法一般在# 后跟个空格再写文字。
示例：

# 这是一级标题
## 这是二级标题
### 这是三级标题

效果：

这是一级标题

这是二级标题

这是三级标题

二、段落

Markdown 段落没有特殊的格式，直接编写文字就好，段落的换行是使用两个以上空格加上回车。使用空行来换行。
示例：

段落1  

段落2  

效果：
段落 1

段落 2

三、字体

加粗：要加粗的文字左右分别用两个 * 号包起来
斜体：要倾斜的文字左右分别用一个 * 号包起来
斜体加粗：要倾斜和加粗的文字左右分别用三个 * 号包起来
删除线：要加删除线的文字左右分别用两个~~ 号包起来
示例：

**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~

效果：
这是加粗的文字
这是倾斜的文字 `
这是斜体加粗的文字
这是加删除线的文字

四、引用

在引用的文字前加 > 即可。引用也可以嵌套，如加两个 >> 三个 >>> 可以一直加下去
示例：

>这是引用的内容
>>这是引用的内容
>>>>>这是引用的内容

效果：

这是引用的内容

这是引用的内容

这是引用的内容

五、分割线

三个或者三个以上的 - 或者 * 都可以。
示例：

---
*****

效果如下：

可以看到，显示效果是一样的。

六、图片

语法：![图片alt](图片地址 ''图片title'')
图片 alt 就是显示在图片下面的文字，相当于对图片内容的解释。
图片 title 是图片的标题，当鼠标移到图片上时显示的内容，title 可加可不加。
示例：

![flower](/usr/uploads/2019/07/2749366889.jpeg "蔷薇花")

效果：

七、超链接

语法：[超链接名](超链接地址 "超链接title")，title 可加可不加。
示例：

[百度](http://baidu.com)

效果：
百度

八、列表

无序列表
语法：无序列表用 - + * 任何一种都可以，注意：- + * 跟内容之间都要有一个空格

- 列表内容
+ 列表内容

效果：

• 列表内容
• 列表内容

有序列表
语法：数字加点，1. 列表内容 2. 列表内容
注意：序号跟内容之间要有空格，数字任填，会自动重新排序
示例：

1. 列表内容
1. 列表内容

效果：

1. 列表内容
2. 列表内容

列表嵌套
上一级和下一级之间敲三个空格即可
示例：

1. 列表内容
   - 列表内容

效果：

1. 列表内容

   • 列表内容

九、表格

语法：

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容。有一个就行，为了对齐，多加了几个。
文字默认居左，两边加：表示文字居中，右边加：表示文字居右。
注：原生的语法两边都要用 | 包起来。此处省略

示例：

姓名|技能|排行
--|:--:|--:
刘备|哭|大哥
关羽|打|二哥
张飞|骂|三弟

效果：

十、代码

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

\`create database hero;\`

代码块：代码之间分别用三个反引号包起来，且两边的反引号单独占一行; 或使用 4 个空格或者一个制表符（Tab 键）。

\`\`\`
function fun(){
echo "这是一句非常牛逼的代码";
}
fun();
\`\`\`

效果：
单行代码
create database hero;
代码块

function fun(){
  echo "这是一句非常牛逼的代码";
}
fun();

十一、转义

显示 markdown 的专有字符可能需要转义，代码块内的内容不会转义。
示例：

\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 大括号
\[\] 中括号
\(\) 小括号
\# 井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号

效果：
\ 反斜杠
\` 反引号
* 星号
\_ 下划线
{} 大括号
[] 中括号
() 小括号
\# 井号
+ 加号
- 减号
. 英文句号
\! 感叹号