简书Markdown 语法说明

参考网站：http://www.appinn.com/markdown/index.html

---

概述宗旨

兼容 HTML
特殊字符自动转换

区块元素段落和换行
标题
区块引用
列表
代码区块
分隔线

区段元素链接
强调
代码
图片

其它反斜杠
自动链接

---

Markdown 支持两种标题的语法

类 Setext 和类 atx 形式。

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

This is an H1
=============
This is an H2
------------

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

# 这是 H1 #
## 这是 H2 ##
### 这是 H3 #####

---

区块引用 Blockquotes

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

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,

This is nested blockquote."嵌套"

这是一个标题。

---

列表

Markdown 支持有序列表和无序列表。

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

• Red

• Red
  1.Bird
  3.McHale
  3.Parish

---

技巧性问题：

1986. What a great season.

---

分隔线

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

* * *

***

*****

- - -

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

---

区段元素

链接

Markdown 支持两种形式的链接语法： 行内式和参考式两种形式。

不管是哪一种，链接文字都是用 [方括号] 来标记。

This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.

---

强调

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

_single underscores_
**double asterisks**
__double underscores__
\*this text is surrounded by literal asterisks\*

---

代码

如果要标记一小段行内代码，你可以用反引号把它包起来（`），例如：

Use the ' printf() ' function.``There is a literal backtick (`) here.

图片

很明显地，要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。

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

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

参考式的图片语法则长得像这样：
![Alt text][id]
[id]: url/to/image "Optional title attribute"

---

自动链接

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

• 星号
  _ 底线
  {} 花括号
  [] 方括号
  () 括弧

井字号

• 加号

• 减号
  . 英文句点
  ! 惊叹号
  加粗
  斜体
  加粗斜体