Markdown语法从入门到不精通

引言

Markdown是一种轻量级的语言，先看看Wikipedia中对Markdown的定义http://en.wikipedia.org/wiki/Markdown。

Markdown如今被广泛的应用，用自己的理解简单的介绍一下基本的常用的Markdown语法。

传送门：

• Markdown最权威的介绍：Markdown Syntax
• 中文版的Markdown语法说明：http://wowubuntu.com/markdown/

目录

一、标题

二、段落

三、区块引用 Blockquotes

四、列表

五、分割线

六、链接

七、图片

八、强调

内容

一、标题

Markdown共支持六个等级的标题，表示方法为在行首插入1——6个#来代表1——6级标题，e.g.

1
2
3
4
5
6

#    这是H1
##    这是H2
###   这是H3
####  这是H4
##### 这是H5
######    这是H6

二、段落

Markdown语法中并不是对所有回车符都代表着换行，具体的说应该是在换行处插入两个或两个以上的空格+回车符才是标准的换行，e.g.

1
2

我要在此处换行（一个空格+一个回车）
失败

显示效果:

我要在此处换行 失败

正确的应该为：

1
2

我要在此处换行（两个或多个空格+一个回车）
成功

显示效果：

我要在此处换行
成功

三、区块引用 Blockquotes

Markdown语法中对区块引用的方式是使用类似email中的>引用方式。Markdown文件中创建一个区块引用，你只需要在每行前都加上一个>就可以了。

1
2
3
4

> Rules for happiness: something to do, someone to love, something to hope
> for.
> 
> If you're not doing what you love, you're wasting your time.

显示效果：

Rules for happiness: something to do, someone to love, something to hope for.

If you’re not doing what you love, you’re wasting your time.

当然你也可以偷懒只在每个段落的开始处加一个>，其实也是可以的，同时区块引用的内部是可以使用其他的Markdown语法的，包括，标题、列表代码区码等。

1
2
3
4
5
6
7
8

> ## 我是标题
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
> 我叫代码块：
> 
>     return "Hello World~";

显示效果 ：

我是标题

1. 这是第一行列表项。
2. 这是第二行列表项。

我叫代码块：

return "Hello World~";

怎么样，是不是很酷~

四、列表

Markdown的列表有无序和有序的两种：

无序列表使用星号、加号或是减号作为列表标记，有序列表是使用数字接着一个英文句点，而且你在列表标记上的数字是不会影响显示效果的。

无序列表：

1
2
3
4
5

*    First
* Second
* Third
+ Forth
- Fifth

显示效果：

• First
• Second
• Third
• Forth
• Fifth

有序列表：

1
2
3
4
5

1.   First
2.    Second
3.    Third
6.    Forth
12.   Fifth

显示效果：

1. First
2. Second
3. Third
4. Forth
5. Fifth

五、分割线

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

1
2
3
4
5
6
7
8
9

* * *

***

*****

- - -

---------------------------------------

六、链接

链接文字都是用 [方括号] 来标记，只要在方块括号后面紧接着圆括号并插入网址链接即可

1
2
3
4
5

['MarK-YANG'](http://mark-yang.github.io)

或：

<http://mark-yang.github.io>

七、图片

Markdown 使用一种和链接很相似的语法来标记图片，详细叙述如下：

• 一个惊叹号 !
• 接着一个方括号，里面放上图片的替代文字
• 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 ‘title’ 文字。

八、强调

Markdown 使用星号（*）和底线（_）作为标记强调字词的符号，被 * 或 _ 包围的字词会被转成用 （斜体）标签包围，用两个 * 或 _ 包起来的话，则会被转成 （加粗），例如，

1
2

**HelloWorld**
*HelloWorld**