Markdown语法简介

Markdown 是一种轻量级标记语言，它用简洁的语法代替排版，让你更加专注于书写。因为其兼容性极强，格式稳定性极高，格式转化方便等特点，已经成为非常适用于网络的书写语言，同时，Markdown支持嵌入html标签。

非技术类用户，千万不要被「标记」、「语言」吓到，Markdown的语法十分简单，常用的标记符号不超过十个，用于日常写作记录绰绰有余，不到半小时就能完全掌握。多益云markdown常用语法归纳如下：

Markdown的常用语法

一、标题

Markdown 标题支持两种形式：

1、用#标记

在 标题开头 加上1~6个#，依次代表一级标题、二级标题....六级标题

// #符号后面必须跟上至少1个空格才有效！
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果如下：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2、用=和-标记

在 标题底下 加上任意个=代表一级标题，-代表二级标题，此种标记方法只有两级标题

一级标题
======

二级标题
----------

效果如下：

一级标题

二级标题

---

二、列表

Markdown 支持有序列表和无序列表，并且支持多级列表，下级列表标签前需加一定空格与上级首部文字对齐

无序列表使用-、+和*作为列表标记：

// -、+、*符号后面必须跟上至少1个空格才有效！

- Red
- Green
- Blue

+ Red
+ Green
+ Blue

* Red
* Green
* Blue

* Red
* Green
* Blue
  * blue
  * blue
  * blue

效果如下：

• Red
• Green
• Blue
  • blue
  • blue
  • blue

有序列表则使用数字加英文句点.来表示：

1. Red
2. Green
3. Blue
   1. Red
   2. Green
   3. Blue

效果如下：

1. Red
2. Green
3. Blue
   1. Red
   2. Green
   3. Blue

---

三、引用

引用采用>标记，引用中支持多级引用、标题、列表、代码块、分割线等常规语法。

标题和列表：

> #### 这是一个四级标题
> * 这是第一行列表项
> * 这是第二行列表项

效果如下：

这是一个四级标题

• 这是第一行列表项
• 这是第二行列表项

多级引用：

> 一级引用
> > 二级引用
> > > 三级引用

效果如下：

一级引用

二级引用

三级引用

引用代码块则需在>后边加5个空格：

>      //在>后面有 5 个空格
>      protected void onCreate(Bundle savedInstanceState) {
>          super.onCreate(savedInstanceState);
>          setContentView(R.layout.activity_main);
>      }

效果如下：

 //在>后面有 5 个空格
 protected void onCreate(Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);
     setContentView(R.layout.activity_main);
 }

---

四、强调

一个*或-代表斜体，两个*或-代表加粗，三个*或-代表即倾斜又加粗，~~代表删除。

**加粗文本** 或者 __加粗文本__

*斜体文本*  或者_斜体文本_

***斜粗文本***  或者___斜粗文本___


~~删除文本~~

效果如下：

加粗文本 或者 加粗文本

斜体文本 或者斜体文本

斜粗文本 或者斜粗文本

删除文本

---

五、图片与链接

图片与链接的语法很像，区别在一个 ! 号。二者格式：

图片：![]()    ![图片文本(可忽略)](图片地址)

链接：[]()     [链接文本](链接地址)or链接地址

例如:

这是链接：[多益云](http://yun.duoyi.com/)。

这是图片：

![多益云](https://yun.duoyi.com/images/offical/index_logo.png)

效果如下：

这是链接：多益云。

这是图片：

多益云

---

六、代码

代码分为行内代码和代码块。

• 行内代码使用 ` 标识，分别置于代码前后，可嵌入文字中

` super.onCreate(savedInstanceState);`

效果如下：

super.onCreate(savedInstanceState);

• 代码块使用```标识，分别置于代码块上下两行

• 代码语法高亮在 ```后面加上语言名称即可

``` java
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
}```

效果如下：

protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
}

---

七、表格

表格之间采用|进行分割，采用---分割表头和内容；

表格对齐格式：
默认（居左）：----
居左：:---
居中：:---:
居右： ---:

|标题|标题|标题|
|:---|:---:|---:|
|居左测试文本|居中测试文本|居右测试文本|
|居左测试文本1|居中测试文本2|居右测试文本3|
|居左测试文本11|居中测试文本22|居右测试文本33|

效果如下：

标题	标题	标题
居左测试文本	居中测试文本	居右测试文本
居左测试文本1	居中测试文本2	居右测试文本3
居左测试文本11	居中测试文本22	居右测试文本33

八、分隔线

在一行中用三个以上的*、-、_、*来建立一个分隔线，行内不能有其他东西。也可以在符号间插入空格。

---
***
---
___

* * *

效果如下：

---

以上为markdown的常用语法，快去尝试在你的工作报告中开启markdown的写作之路吧。