MarkDown 使用教程

导语

Markdown 是一种轻量级的「标记语言」，它的优点很多，目前被越来越多的写作爱好者，撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑，Markdown 的语法十分简单。常用的标记符号也不超过十个，这种相对于更为复杂的 HTML 标记语言来说，Markdown 可谓是十分轻量的，学习成本也不需要太多，且一旦熟悉这种语法规则，会有一劳永逸的效果。

使用 Markdown 的优点

• 专注你的文字内容而不是排版样式，安心写作。
• 轻松的导出 HTML、PDF 和本身的 .md 文件。
• 纯文本内容，兼容所有的文本编辑器与字处理软件。
• 随时修改你的文章版本，不必像字处理软件生成若干文件版本导致混乱。
• 可读、直观、学习成本低。

斜体和粗体

Markdown 的粗体和斜体也非常简单，用两个 * 包含一段文本就是粗体的语法，用一个 * 包含一段文本就是斜体的语法。

语法示例：

这是*斜体*，这是**粗体**。

效果：

这是 斜体，这是 粗体。

分级标题

标题是每篇文章都需要也是最常用的格式，在 Markdown 中，如果一段文字被定义为标题，只要在这段文字前加 # 号即可。

语法示例：

# 这是一个一级标题

## 这是一个二级标题

### 这是一个三级标题

图片与链接

插入链接与插入图片的语法很像，区别在一个 !号。

图片为：![图片名字](图片链接)

链接为：[链接名字](链接地址)

语法示例：

这是去往 [我的博客](http://www.wujiayi.vip) 的链接。

![我的头像](https://avatars3.githubusercontent.com/u/30690400?v=4&s=460)

效果：

这是去往 我的博客 的链接。

无序列表 & 有序列表

熟悉 HTML 的同学肯定知道有序列表与无序列表的区别，在 Markdown 下，列表的显示只需要在文字前加上 - 或 * 即可变为无序列表，有序列表则直接在文字前加1. 2. 3.符号要和文字之间加上一个字符的空格。

示例：

- 无序列表项 一
- 无序列表项 二
- 无序列表项 三

1. 有序列表项 一
2. 有序列表项 二
3. 有序列表项 三

效果：

• 无序列表项 一
• 无序列表项 二
• 无序列表项 三

1. 有序列表项 一
2. 有序列表项 二
3. 有序列表项 三

文字引用

使用 > 表示文字引用。

示例：

> 野火烧不尽，春风吹又生。

效果：

野火烧不尽，春风吹又生。

行内代码块

使用 `代码` 表示行内代码块。 ( “ ` ” 这个按键在 ESC 下面 )

示例：

 让我们聊聊 `html`。

效果：

让我们聊聊 html。

代码块

使用 四个缩进空格 或 ``` 表示代码块。

示例：

这是一个代码块，此行左侧有四个不可见的空格。

@requires_authorization
class SomeClass:
    pass

if __name__ == '__main__':
    # A comment
    print 'hello world'

分隔线

使用三个减号来实现分隔线。

示例：

---

目录结构

在段落中填写 [TOC] 以显示全文内容的目录结构。

示例：

[toc]

绘制表格

通过 | 和 - 会绘制表格。（相比其他语法，这个稍微有点麻烦！）

示例：

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

效果：

以上