markdown 语法_Markdown 基本语法

Markdown 是一种轻量级的标记语言（markup language），由 John Gruber（1973 ~）与 Aaron Swartz （1986 ~ 2013）于2004年创造，被网站用于编写说明文件（readme）、技术文档或在论坛上发布信息。由于其语法简单，易于读写，且编写出的作品简洁美观，目前也被越来越多的人群用于日常写作、发布电子书甚至书写电子邮件。可以说，Markdown 是极简主义（minimalism）的代表作品。

简单说，Markdown 有如下优势：

• 语法简单，易于学习
• 简洁美观，易于阅读
• 兼容 HTML，可以添加丰富的样式
• 跨平台
• 越来越多的网站支持

本文包括以下内容：

• 通用格式；
• 绘制表单；
• 引入链接；
• 引入公式、代码；
• 使用表情（emoji）；
• 绘图简介；

通用格式

标题

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

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

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题

字体

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

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

引用

• 在引用的文字前加>即可
• 引用也可以嵌套，如>>，>>>

> 这是引用的内容

这是引用的内容

分割线

• 三个或者三个以上的 - 或 *

---

----

***

*****

---

外部链接

图片

• 

图片alt就是显示在图片下面的文字，相当于对图片内容的解释
图片title是图片的标题，当鼠标移到图片上时显示的内容。title可加可不加

![知乎](https://pic2.zhimg.com/80/v2-48bbd284deacef0b5896427e660b2a51_1440w.png "知乎")

超链接

• 超链接名
• title可加可不加

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

百度

html

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

<a href = "https:/www.jianshu.com/u/1f5ac0cf6a8b" target = "_blank">知乎</a>

知乎

表单

无序列表

• 无序列表用 - + * 任何一种都可以

- 列表内容
+ 列表内容
* 列表内容

• 列表内容

有序列表

• 数字加点

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

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

列表嵌套

• 上一级和下一级之间敲3个空格即可

- 一级无序列表内容
   - 二级无序列表内容
     - 三级无序列表内容
      - 四级无序列表内容

• 一级无序列表内容
  • 二级无序列表内容
    • 三级无序列表内容
      • 四级无序列表内容

表格

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

• 第二行分割表头和内容
• 有一个就行，为了对齐，多加了几个
• 文字默认居左
• -两边加：表示文字居中
• -右边加：表示文字居右

代码、公式

代码块

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

`代码内容`

代码内容

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

labels = []
markers = ['o', 'd', 'r']
colors = ['red', 'blue', 'green']

for i in range(2):
    time = mix.Time[0+i*6, 6+i*6]
    normal = mix.Normal[0+i*6, 6+i*6]
    ldir = mix.LDIR[0+i*6, 6+i*6]

    plt.plot(time, normal, label=labels[i], marker=markers[i], color=colors[i])
    plt.plot(time, ldir, label=rlabels[i], marker=markers[i], color=colors[i], linestyle='.-')

公式

• 行内

$Gamma(n) = (n-1)! quadforall n inmathbb N$

• 块级

$$
x = dfrac{-b pm sqrt{b^2 - 4ac}}{2a}
$$

扩展格式上、下标
```markdown
OH^-^
KBrO~3~
```

复选框
```markdown
- [ ]
- [x]
```

高亮
```markdown
==高亮==
```

表情
目前，大多数的 markdown 编辑器都支持了 emoji，其基本格式为，:英文单词:，如
```markdown
:sunflower:
:cat:
:bike:
:icecream:
:running:
:ski:
```

绘图

Markdown 支持绘图插件，目前比较流行的有 Mermaid.js 和 ditta。其中，Mermaid.js 是完全 Markdown 风格的语言，可以与 Markdown 文档做到无缝衔接。关于 Mermaid.js 的使用，可参阅

请服我一把：Markdown 绘图（Mermaid.js）​zhuanlan.zhihu.com

作为极简主义的代表作之一，Markdown 未来的生态会越来越丰富。