Markdown

宗旨

Markdown 的目标是实现「易读易写」。

可读性，无论如何，都是最重要的。
一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布，并且看起来不会像是由许多标签或是格式指令所构成。
总之， Markdown 的语法全由一些符号所组成，这些符号经过精挑细选，其作用一目了然。

兼容 HTML

Markdown 不是想要取代 HTML，也不是要使得 HTML 文档更容易书写。而是允许内嵌 HTML 编码。
Markdown 的理念是，能让文档更容易读、写和随意改。Markdown 的格式语法只涵盖纯文本可以涵盖的范围。

不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。
不需要额外标注这是 HTML 或是 Markdown；只要直接加标签就可以了。

要制约的只有一些 HTML 区块元素――比如 <div>、<table>、<pre>、<p> 等标签，
必须在前后加上空行与其它内容区隔开，还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。
Markdown 的生成器有足够智能，不会在 HTML 区块标签外加上不必要的 <p> 标签。

请注意，在 HTML 区块标签间的 Markdown 格式语法将不会被处理。
比如，你在 HTML 区块内使用 Markdown 样式的*强调*会没有效果。

HTML 的区段（行内）标签如 <span>、<cite>、<del> 可以在 Markdown 的段落、列表或是标题里随意使用。
依照个人习惯，甚至可以不用 Markdown 格式，而直接采用 HTML 标签来格式化。
与处在 HTML 区块标签间不同，Markdown 语法在 HTML 区段标签间是有效的。

语法

1. 标题

Markdown提供了两种方式(Setext 和 Atx)来显示标题。

Setext方式:

标题1
=================

标题2
-----------------

Atx方式:

# 标题1
## 标题2
###### 标题6

注意： 标题2的写法会自动加横线。

2. 换行

在文字的末尾使用两个或两个以上的空格来表示换行。

3. 引用

行首使用>加上一个空格表示引用段落，内部可以嵌套多个引用。
可以在每行的最前面加上 “>”，也可以只在整个段落的第一行最前面加上 “>”。
引用段落里面的换行，还得使用 Markdown 的行末加两个空格。

> 这是一个引用，
> 这里木有换行，   
> 在这里换行了。
> > 内部嵌套

4. 列表

无序列表使用*、+或-后面加上空格来表示。
有序列表使用数字加英文句号加空格表示。

* Item 1
* Item 2
* Item 3

+ Item 1
+ Item 2
+ Item 3

- Item 1
- Item 2
- Item 3

1. Item 1
2. Item 2
3. Item 3

5. 代码区域

行内代码使用反斜杠`括起来表示。
代码段落则是在每行文字前加4个空格或者1个缩进符表示,此段落必须在前后加上空行与其它内容区隔开。

行内的如 Something
段落的如:

echo 'Something'

6. 强调

Markdown使用 * 或 _ 表示强调，显示效果为斜体和加粗。

单星号 = *斜体*
单下划线 = _斜体_
双星号 = **加粗**
双下划线 = __加粗__

7. 链接

Markdown支持两种风格的链接：Inline和Reference。

Inline：  
以中括号标记显示的链接文本，后面紧跟用小括号包围的链接。
如果链接有title属性，则在链接中使用空格加双引号引起"title属性"。
如：  [链接文字](链接地址 "可选的title")

Reference：  
一般应用于多个不同位置使用相同链接。通常分为两个部分，调用部分为[链接文本][ref]；  
定义部分可以出现在文本中的其他位置，格式为[ref]: http://some/link/address (可选的标题)。  
注：ref中不区分大小写，这名称可以自定义。

这是一个 Inline 示例。
这是一个 Reference 示例。

8. 图片

图片的使用方法基本上和链接类似，只是在中括号前加叹号。
注：Markdown不能设置图片大小，如果必须设置则应使用HTML标记<img>。

Inline示例：![替代文本](/assets/images/jian.jpg "可选的title")
Reference示例：![替代文本][pic]
[pic]: /assets/images/ship.jpg "可选的title2"
HTML示例：<img src="/assets/images/jian.jpg" alt="替代文本" title="标题文本" width="200" />

9. 自动链接

使用尖括号，可以为输入的URL或者邮箱自动创建链接。

如： <test@domain.com>、<http://db.tt/ORtPX1Y3>

10. 分隔线

在一行中使用三个或三个以上的 * 、 - 或 _ 可以添加分隔线，其中可以有空白，但是不能有其他字符。

***
---
_  _  _

11. 转义字符

Markdown中的转义字符为\，可以转义的有：

\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 大括号
\[\] 中括号
\(\) 小括号
\# 井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号