Markdown

Markdown

简介

Markdown是一种可在普通文本编辑器编写的标记语言，通过简单的标记语法，使普通文本内容具有一定的格式。

Markdown的语法简洁明了、学习容易，而且功能比纯文本更强。可以使作者把主要精力放在内容上。因此有很多人用它写博客。

---

标记语法

标题

方法一：使用“=”和“-”表示（一级标题）和（二级标题）。数量没有要求。

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

显示为：

This is an H1

This is an H2

方法二：使用“#”号数量表示标题级别，最多六级。

#一级标题
##二级标题
###三级标题
####四级标题
#####五级标题
######六级标题

显示为

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

---

区块引用

*常规方法：每行的行首增加 > ， 可以多级嵌套， >> 为引用的引用，类推。

> 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.
> 
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.

显示为

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.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

*简化方法：整个段落的可以只在第一行行首增加 >， 效果相同。

> 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.

> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

显示为

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.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

---

列表

1. 无序列表： 使用“+”， “-”， “*”号, 后面要有空格。

+ item1
+ item2
+ item3
- item1
- item2
- item3
* item1
* item2
* item3

显示为

• item1
• item2
• item3
• item1
• item2
• item3
• item1
• item2

• item3

  1. 有序列表： 使用数字加英文句号”.”, 后面要有空格。数字不会影响输出顺序和标号。乱序第一行前要有空行。

1. item1
2. item2
3. item3

显示为

1. item1
2. item2
3. item3

乱序

10. item1
20. item2
5. item3

显示为

1. item1
2. item2
3. item3

代码块

方法一：使用标签

<pre><code>
这是一个代码区块。
</code></pre>

显示为

这是一个代码区块。

方法二：只要简单地缩进 4 个空格或是 1 个制表符就可以建立代码区块

    这是一个代码区块。

显示为

这是一个代码区块。

方法三：使用““`”

“`
这是一个代码区块。
这是一个代码区块。
“`

显示为

这是一个代码区块。
这是一个代码区块。

方法四：使用“`”, 标记的代码块将变为一行。

`
这是一个代码区块。
这是一个代码区块。
`

显示为


这是一个代码区块。
这是一个代码区块。


分割线

用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。“——-”上有字会变成二级标题。

* * *

***

*****

- - -

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

显示为

---

---

---

---

---

链接

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

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

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

显示为

This link has no title attribute.
This is an example inline link.

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

This is [an example][foo] reference-style link.

[foo]: http://example.com/  "Optional Title Here"

显示为

This is an example reference-style link.

an example 为链接文件
foo 为链接标识，需要在其他地方定义

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

---

图片

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

• 行内式：

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

显示为

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

• 参考式：id是图片参考的名称，图片参考的定义方式则和连结参考一样

![Alt text][id]

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

显示为

---

表格

第一行列标题，第二行格式，后面是数据。 可简化行首和行尾的“|”

|列标题1 | 列标题2 | 列标题3   |
|:-:|:- |-:|
| 数据 | 数据 | 数据 |

显示为

列标题1	列标题2	列标题3
数据	数据	数据

:-: 居中
:- 向左对齐
-: 向右对齐

样式

*斜体*
**粗体**
***斜体+粗体***
~~~删除线~~~

显示为

斜体
粗体
斜体+粗体
~删除线~

参考
百度百科
markdown