markdown使用总结

# markdown简介
> Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成格式丰富的HTML页面。 —— [维基百科](

https://zh.wikipedia.org/wiki/Markdown)

# markdown的优缺点
* **优点**
* 语法简洁
* 简单、轻量级
* 标签有行业标准
* 应用广泛(GitHub、Reddit、StackOverFlow、JianShu)
* 相应的工具支持很好。(pandoc、sublime Text 2)
* **缺点**
* 表格实现需要html代码

# markdown基本语法
## 段落
一个段落是由一个以上的连接的行句组成，而一个以上的空行则会划分出不同的段落（空行的定义是显示上看起来像是空行，就被视为空行，例如有一行只有空白和 tab，那该行也会被视为空行），一般的段落不需要用空白或换行缩进。

## 标题
markdown支持两种标题语法，`Setext`和`Atx`形式。
* `Setext`是在标题文字底部用底线的形式，用`=`（1级标题）和`-`（2级标题）。
1级标题
==
2级标题
—

* `Atx`实在标题文字前面插入`#`，最多可以插入6个`#`，也就是最多支持6级标题。
在文字是`#`，几个`#`代表几级标题（最多支持6级标题）。
# 1级标题
## 2级标题
### 3级标题

>建议在`#`和标题之间建议保留一个字符的空格，这是最标准的 Markdown 写法。
## 字体
* 粗体：文字两头使用2个`*`和`_`进行标记
**粗体**、__粗体__
* 斜体：文字两头使用1个`*`和`_`进行标记
*斜体*、_粗体_

##列表
* **无序列表**

在列表开头添加`*`、`+`或`_`等符号标记。需要注意的是这些符号和文字之间需要添加`空格`，要显示二级列表则在符号前面增加`空格`。

>* 无序列表
>* 无序列表

* **有需列表**

在列表开头依次添加`数字`、`.`、`空格`进行标记，数字可以随便写，markdown可以自动更正。

>1. 有序列表
>2. 有序列表
>2. 有序列表
>2. 有序列表

## 链接
链接分为`内联`和`引用`两种方式。
* 内联
行内形式是直接在后面用括号直接接上链接。
This is an [example link](http://example.com/).
也可以选择性加上title属性。
This is an [example link](http://example.com/ “With a Title”).
* 引用
应用形式的链接让你可以为链接定一个名称（链接名称可以用字母、数字和空格，但是不分大小写），之后你可以在文件的其他地方定义该链接的内容。
I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].

[1]: http://google.com/ “Google”
[2]: http://search.yahoo.com/ “Yahoo Search”
[3]: http://search.msn.com/ “MSN Search”

## 代码
在一般的段落文字中，你可以使用反引号来标记代码区段，区段内的 &、< 和 > 都会被自动的转换成 HTML 实体，这项特性让你可以很容易的在代码区段内插入 HTML 代码。
``

## 区块引用
在文字使用`>`标记。
>区块引用

## 下划线
在空白行下方输入三个或三个以上`-`、`*`、`_`。

—
****
___

## 代码
* 行内代码
在代码前后使用反引号进行标记。
``
* 代码块（部分markdown编辑器支撑语法高亮）
在代码块前后使用3个反引号进行标记。
“`



“`

## 图片
图片的语法和链接很像，只是前面多了一个`!`。
* 行内形式（title 是选择性的）：
* 参考形式：
![图片][id]
[id]: /path/to/img.jpg “Title”

## 表格（有些markdown编辑器不支持）
表示以`|`进行分隔，在表头和数据行中间，可以定义。
#### 表格
| Item | Value | Qty |
| :——– | ——–:| :–: |
| Computer | 1600 USD | 5 |
| Phone | 12 USD | 12 |
| Pipe | 1 USD | 234 |

#参考资料
1. [Markdown 语法说明 (简体中文版)](http://wowubuntu.com/markdown/)
2. [献给写作者的 Markdown 新手指南](http://www.jianshu.com/p/q81RER)
3. [为什么作家应该用 Markdown 保存自己的文稿](http://jianshu.io/p/qqGjLN)
4. [Markdown写作浅谈](http://jianshu.io/p/PpDNMG)
5. [马克飞象](http://maxiang.info/)
6. [三分钟学会书写格式良好的笔记（Markdown）](http://blog.wiz.cn/markdown.html)