Markdown介绍

Markdown介绍

Markdown是一种轻量级的标记语言。主要用于写出带有格式的文档。有点类似于HTML语言，但是语法要比HTML语言简单，十分适合书写文档。而且现在大部分博客和文章输入系统都支持这种语法。例如有道笔记和印象笔记等等。在Github上写的REAME.md就是这种语法写出来的说明文档。而且会在Github上直接显示出带有格式的文档结果。

Markdown优点

1. 专注于文字内容，提供简单的排版语法。排版语法可以和文字内容融合。
2. 很多的文字编辑工具支持这种语法。包括Atom，IDE，有道笔记，Evernote和博客网站。
3. 容易学习，语法简单。
4. 可以导出HTML，PDF文件
5. 使用Word软件写出的文档无法记录修改的内容，而md文件可以使用Git软件记录更改的内容。追溯修改的过程。
6. 扩展部分可以支持流程图，复杂的数学公式使用文字来描述。

Markdown语法

标题

Markdown 支持两种标题的语法，类 Setext 和类 atx 形式。

Setext形式标题

类 Setext 形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题），例如：

This is an H1
=============

This is an H2
-------------

Atx形式标题

文章的标题格式是最左侧加上#符号，之后有一个空格，最后右侧写上标题内容。一个井号代表一级标题，两个井号代表二级标题，以此类推，一共有6级。

# 这是 H1

## 这是 H2

###### 这是 H6

列表

无序列表

无序列表使用星号、加号或是减号作为列表标记. 例如：

*   Red
*   Green
*   Blue

或者

+   Red
+   Green
+   Blue

等同于：

-   Red
-   Green
-   Blue

有序列表

有序列表是指在列表的每一行前面带有1, 2, 3...数字。这种列表需要在每一行文字前面增加数字+点的方式。例如"1."。然后再接文字。

引用

Markdown 标记区块引用是使用类似 email 中用 >的引用方式。使用大于号在文字前面。

区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的 >。

图片

图片是在一个对图片的连接，而不是能嵌入图片。有点像html的img标签的src属性。具体的写法为：![Alt text](image_url)

链接

Markdown 支持两种形式的链接语法： 行内式和参考式两种形式。不管是哪一种，链接文字都是用 [方括号] 来标记。

行内参

格式为: [an example](http://example.com/ "Title").

一般简写成[an example](http://example.com/)

参考式

参考式的链接是在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记：
This is [an example][id] reference-style link.

然后在下面的参考位置定义ID的值:
[id]: http://example.com/ "Optional Title Here"

链接网址也可以用尖括号包起来。

[id]: <http://example.com/>  "Optional Title Here"

隐式链接标记

隐式链接标记功能让你可以省略指定链接标记，这种情形下，链接标记会视为等同于链接文字，要用隐式链接标记只要在链接文字后面加上一个空的方括号，如果你要让 "Google" 链接到 google.com，你可以简化成：

[Google][]

然后定义链接内容：

[Google]: http://google.com/

链接的定义可以放在文件中的任何一个地方，我比较偏好直接放在链接出现段落的后面，你也可以把它放在文件最后面，就像是注解一样。

粗体

使用两个**和两个下划线围绕文字的左右侧。

斜体

使用*和一个下划线围绕文字的左右侧。

注意： 如果你的 * 和 _ 两边都有空白的话，它们就只会被当成普通的符号。

表格

格式如下

|  列表头1       |  列表头2       |  列表头3  |
| ------------- |:-------------:| --------:|
| 内容1          | 内容2         | 内容3     |
| 内容1          | 内容2         | 内容3     |

上面的:代表对齐的方式。如果冒号两边都有那么代表居中对齐。

代码框。

代码框是程序员写的文档经常用到的。格式有多种，一种是使用单个反引号（一般在键盘的左侧tab键的上面），把代码包围起来。还有一种使用三个反引号把代码包围起来。如果代码是多行的，建议使用三个反引号比较好，其还可以指定代码的类型，例如是Python代码，或者HTML代码，这样显示的效果可以带有语法高亮。

分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。

转义字符

Markdown语法使用的字符如何与你写的文档中的字符有冲突，那么可以使用来转义Markdown的字符，变成普通的文字符号。

Markdown提供对如下字符的转义：

   backslash
`   backtick
*   asterisk
_   underscore
{}  curly braces
[]  square brackets
()  parentheses
#   hash mark
+   plus sign
-   minus sign (hyphen)
.   dot
!   exclamation mark

特殊字符

Markdown兼容HTML中一些特殊字符写法。例如版权符号使用@copy;

---

参考:

• http://wowubuntu.com/markdown/
• http://daringfireball.net/projects/markdown/syntax
• http://www.jianshu.com/p/1e402922ee32/