Markdown语法说明

一、概述

1，宗旨

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

1）Markdown 让你专注于文字，而不是排版。
2）Markdown标记语法有极好的可读性。
3）它的格式转换方便，可以轻松转换为html、电子书等文件

2，兼容HTML

Markdown语法的目标是：成为一种适用于网络的书写语言

Markdown 的理念是，能让文档更容易读、写和随意改。
HTML 是一种发布的格式，Markdown 是一种书写的格式。就这样，Markdown 的格式语法只涵盖纯文本可以涵盖的范围。

注意：要制约的只有一些 HTML 区块元素――比如<div>、<table>、<pre>、<p>等标签，必须在前后加上空行与其它内容区隔开，还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。
注意：处在 HTML 区块标签间的 Markdown 格式语法将不会被处理。
注意：处在 HTML 区块标签间不同，Markdown 语法在 HTML 区段标签（行内）间是有效的

3，特殊字符自动转换

1）在 HTML 文件中，有两个字符需要特殊处理：< 和&
2）需要注意的是，code 范围内，不论是行内还是区块，< 和&两个符号都一定会被转换成 HTML 实体

二、区块元素

1，段落与换行

一个 Markdown 段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行（空行的定义是显示上看起来像是空的，便会被视为空行。

「由一个或多个连续的文本行组成」这句话其实暗示了 Markdown 允许段落内的强迫换行（插入换行符）。

&）如果你确实想要依赖 Markdown 来插入<br />标签的话，在插入处先按入两个以上的空格然后回车。

2，标题

只需在文本前面加上“#”号即可，注意在“#”号与文本之间加上一个空格，如：
<p># 一级标题
## 二级标题
###### 六级标题</p>

3，区块引用

1）在每行的最前面加上>
2）Markdown 也允许你偷懒只在整个段落的第一行最前面加上>
3）区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的>
4）引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等。

4，列表

1）无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记：
<p>- list1
- list2
- list3
</p>

• list1
• list2
• list3

2）有序列表则使用数字接着一个英文句点：
（测试：列表的1，2，3文字是选不中的）
<p>1. list1
2. list2
3. list3</p>

1. list1
2. list2
3. list3

5，代码区块

和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块，通常这些区块我们并不希望它以一般段落文件的方式去排版，而是照原来的样子显示，Markdown 会用<pre>和<code>标签来把代码区块包起来。

要在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以。

这就是一个代码区块，

在代码区块里面，&、<和>会自动转成 HTML 实体，这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码，只需要复制贴上，再加上缩进就可以了，剩下的 Markdown 都会帮你处理，比如：

<div class="css">
  <p class="para"></p>
</div>

6，分隔线

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

---

三、区段元素

1，链接

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

3）要建立一个行内式的链接，只要在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，例如：

This is [an example](http://example.com/ "Title") inline link.

This is an example inline link.

4）参考式的链接是在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记：

This is [an example][id] reference-style link.
[id]: http://example.com/  "Optional Title Here"

This is [an example][id] reference-style link.
[id]: http://example.com/ "Optional Title Here"

参考式链接内容定义的形式为：

[reference-style link]: http://example.com/  "Optional Title Here"

• 方括号（前面可以选择性地加上至多三个空格来缩进），里面输入链接文字
• 接着一个冒号
• 接着一个以上的空格或制表符
• 接着链接的网址
• 选择性地接着 title 内容，可以用单引号、双引号或是括弧包着

2，强调

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

*single asterisks*
_single underscores_

**double asterisks**
__double underscores__

single asterisks
single underscores

double asterisks
double underscores

如果要在文字前后直接插入普通的星号或底线，你可以用反斜线：*, _

3，代码

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

Use the `printf()` function.

这段语法会产生：

<code>There is a literal backtick (`) here.</code>

在代码区段内，&和尖括号都会被自动地转成 HTML 实体，这使得插入 HTML 原始码变得很容易。

4，图片

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

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

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

详细描述如下：

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

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

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

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

四、其他

1，反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果（但不用<em>标签），你可以在星号的前面加上反斜杠：

\*literal asterisks\*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

2，自动链接

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

Markdown代码：

<http://example.com/>

转为HTML代码：

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

网页表现：
http://example.com/

五、感谢

六、Markdown 免费编辑器

1，Windows 平台

• MarkdownPad
• MarkPad

2，Linux 平台

• ReText

3，Mac 平台

• Mou

4，在线编辑器

• Markable.in
• Dillinger.io

5，浏览器插件

• MaDe(Chrome)

6，高级应用

• Sublime Text 2+MarkdownEditing/教程