MarkDown常用语法

参考资料：markdown中文文档：

markdown也用了一段时间了，今天系统的看一下常用语法，总结如下：

标题

Markdown 支持两种标题的语法，类 Setext 和类 atx 形式。
Setext是底线形式， 利用=（最高阶标题）和-（第二阶标题），如：

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

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

任何数量的 = 和 - 都可以有效果。

Atx 形式则是在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶，例如：

# 这是 H1

## 这是 H2

###### 这是 H6

你可以选择性地「闭合」类 atx 样式的标题，这纯粹只是美观用的，若是觉得这样看起来比较舒适，你就可以在行尾加上 #，而行尾的 # 数量也不用和开头一样（行首的井字符数量决定标题的阶数）：

# 这是 H1 #

## 这是 H2 ##

### 这是 H3 ######

区块引用

Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。如果你还熟悉在 email 信件中的引言部分，你就知道怎么在 Markdown 文件中建立一个区块引用，那会看起来像是你自己先断好行，然后在每行的最前面加上 > ：

> 第一行引用
> 第二行引用

Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > ：

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

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

> This is the first level of quoting.
>
> > This is nested blockquote.

引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等：

> ## 这是一个标题。
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
> 给出一些例子代码：
> 
>     return shell_exec("echo $input | $markdown_script");

列表

Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记：

*   Red
*   Green
或者
+   Red
+   Green
或者
-   Red
-   Green

有序列表则使用数字接着一个英文句点：

1.  Bird
2.  McHale
3.  Parish

很重要的一点是，你在列表标记上使用的数字并不会影响输出的 HTML 结果，上边的数字不论怎么写，都会按顺序输出。

代码区块

要在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以，例如，下面的输入：

这是一个普通段落：
    这是一个代码区块

分割线

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

* * *
***
*****
- - -
------------------------------------

链接

Markdown 支持两种形式的链接语法：

[链接内容](链接url"链接hover时的title")

例如：

This is 链接内容 inline link.

强调

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

//一个是斜体
*single asterisks*

_single underscores_
//两个是加粗
**double asterisks**

__double underscores__

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

代码

如果要标记一小段行内代码，你可以用反引号(esc下边那个键)把它包起来（`），例如：

Use the `printf()` function.

Use the printf() function.

图片

Markdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式： 行内式和参考式。

行内式的图片语法看起来像是：

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

• 一个惊叹号 ！
• 接着方括号，里边是图片的替代文字
• 接着普通括号，里边是图片地址。后边还可以用引号包住，加上”title”文字

参考式的图片语法则长得像这样：

![Alt text][id]
[id]: url/to/image  "Optional title attribute"

到目前为止， Markdown 还没有办法指定图片的宽高，如果你需要的话，你可以使用普通的 标签。

自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用尖括号包起来， Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样，例如：http://example.com/

<http://example.com/>
转为：
<a href="http://example.com/">http://example.com/</a>