Markdown 编辑器指南

一直觉得博客园默认的编辑器不好用，后来了解了Markdown，并且博客园也支持Markdown标记，所以写篇博客总结下。

一、认识 Markdown

Markdown 是一种用来写作的轻量级「标记语言」，它用简洁的语法代替排版，而不像一般我们用的字处理软件 Word 有大量的排版、字体设置。它使我们专心于码字，用「标记」语法，来代替常见的排版格式。例如此文从内容到格式，甚至插图，键盘就可以通通搞定了。

优点：

1、因为是纯文本，所以只要支持Markdown的地方都能获得一样的编辑效果，可以让作者摆脱排版的困扰，专心写作。

2、操作简单。比如：Word编辑时标记个标题，先选中内容，再点击导航栏的标题按钮，选择几级标题。要三个步骤。而Markdown只需要在标题内容前加#即可。

缺点：

1、需要记一些语法（当然，是很简单。五分钟学会）。

2、有些平台不支持Markdown编辑模式。

二、Markdown 基本语法

2.1 标题

在想要设置为标题的文字前面加#来表示，一个#是一级标题，二个#是二级标题，以此类推。支持六级标题。

示例：

# 这是一级标题

## 这是二级标题

### 这是三级标题

#### 这是四级标题

##### 这是五级标题

###### 这是六级标题

由于我重新设置了博客园的标题相关CSS，显示的标题不再是博客园默认的样式，所以这里就不展示效果了。

注：标准语法一般在#后跟个空格再写文字，但也有些网站的编辑器不加空格也行。

2.2 字体

加粗

要加粗的文字左右分别用两个*号包起来
斜体

倾斜的文字左右分别用一个*号包起来
斜体加粗

要倾斜和加粗的文字左右分别用三个*号包起来
删除线

要加删除线的文字左右分别用两个~~号包起来

示例：

**这是加粗的文字**

*这是倾斜的文字*`

***这是斜体加粗的文字***

~~这是加删除线的文字~~

效果：

这是加粗的文字

这是倾斜的文字`

这是斜体加粗的文字

这是加删除线的文字

2.3 引用

在引用的文字前加>即可。引用也可以嵌套，如加两个>>，加三个>>>，n个...；貌似可以一直加下去，但没神马卵用。

示例：

>这是引用的内容

>>这是引用的内容

效果：

这是引用的内容

这是引用的内容

2.4 分割线

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

示例：

---

效果：

2.5 图片

语法：

![alt 属性文本](图片地址 "可选标题")

开头一个感叹号 !
接着一个方括号，里面放上图片的替代文字
接着一个普通括号，里面放上图片的网址，最后的"可选标题"是当鼠标移到图片上时显示的内容

示例：

![RUNOOB 图标](http://static.runoob.com/images/runoob-logo.png "RUNOOB")

效果：

2.6 链接

语法：

[链接名称](链接地址 "链接title")

title可加可不加

示例：

[博客园](https://www.cnblogs.com/)

效果：

博客园

注：Markdown本身语法不支持链接在新页面中打开，如果想要在新页面中打开的话可以用html语言的a标签代替。

<a href="超链接地址" target="_blank">超链接名</a>

## 示例

<a href="https://www.cnblogs.com/" target="_blank">博客园</a>

2.7 列表

Markdown 支持有序列表和无序列表，并且支持列表嵌套。

无序列表

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

- 列表内容

+ 列表内容

* 列表内容

## 注意：- + * 跟内容之间都要有一个空格

效果：

列表内容
列表内容
列表内容

有序列表

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

1. 列表内容

2. 列表内容

3. 列表内容

## 注意：序号跟内容之间要有空格

效果：

列表内容
列表内容
列表内容

列表嵌套

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

1. 第一项：

    - 第一项嵌套的第一个元素

    - 第一项嵌套的第二个元素

2. 第二项：

    - 第二项嵌套的第一个元素

    - 第二项嵌套的第一个元素

效果：

第一项：
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
第二项：
- 第二项嵌套的第一个元素
- 第二项嵌套的第一个元素

2.8 表格

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

示例：

|  表头   | 表头  |

|  ----  | ----  |

| 单元格  | 单元格 |

| 单元格  | 单元格 |

效果：

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

2.9 代码

单行代码

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

示例：

`代码内容`

效果：

代码内容

代码块

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

示例：

```

int main (int argc, char *argv[])

{

	return 0;

}

```

效果：

int main (int argc, char *argv[])

{

    return 0;

}

参考：

菜鸟教程-Markdown 教程

Markdown基本语法