Markdown语法(快速入门)

发表于   |  

段落、标题、区块代码

Markdown支持两种标题的语法，Setext和atx形式。Setext形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题），Atx形式在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶。

区块使用则使用 email 形式的 > 角括号。

标题示例

代码：

1
2
3
4
一级标题
=======
二级标题
-------

效果：

一级标题

二级标题

代码:

1
2
3
4
5
6
#一级标题
##二级标题
###三级标题
####四级标题
#####五级标题
######六级标题

效果：

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

区块代码示例

代码：

1
2
3
4
5
>引用文字内容
>
>引用文字内容的第二个段落
>
>### 三级标题

效果：

引用文字内容

引用文字内容的第二个段落

三级标题

修辞和强调

Markdown使用 * 和 _ 来标记需要强调的区段。

强调示例

代码：

1
2
3
4
这里使用了*强调*。
这里也使用了_强调_.
这里使用了**着重强调**。
这里也使用了__着重强调__.

效果：

这里使用了强调。

这里也使用了强调.

这里使用了着重强调。

这里也使用了着重强调.

列表

无序列表示例

无序列表使用 * 、 + 、 - 来做列表的项目标记。

代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
* 项目一
* 项目二
* 项目三

+ 项目1
+ 项目2
+ 项目3    

- 项目a
- 项目b
- 项目c

- 外层列表项目
 + 内层列表项目
 + 内层列表项目
 + 内层列表项目
- 外层列表项目

效果:

  • 项目一
  • 项目二
  • 项目三
  • 项目1
  • 项目2
  • 项目3
  • 项目a
  • 项目b
  • 项目c
  • 外层列表项目
    • 内层列表项目
    • 内层列表项目
    • 内层列表项目
  • 外层列表项目

有序列表示例

有序列表则是使用一般数字接这一个英文句点作为项目标记：

代码：

1
2
3
1. 项目一
2. 项目二
3. 项目三

效果:

  1. 项目一
  2. 项目二
  3. 项目三

如果你在项目之间插入空行，那项目的内容会用 <p> 包裹起来，你也可以在一个项目内放上多个段落，只要在它缩排 4 个空白或 1 个tab。

代码：

1
2
3
* 一个列表项目
	有多个段落
* 另一个列表项目

效果：

  • 一个列表项目

    有多个段落

  • 另一个列表项目

链接

Markdown支援两种形式的链接语法，行内和参考两种形式，两种都可以使用角括号来把文字转成链接。

行内形式链接示例

代码：

1
2
这是个[链接示例](http://drzorm.github.io/)。
这是个[链接示例](http://drzorm.github.io/ "链接示例")。

效果：

这是个链接示例。

这是个带title属性的链接示例。

参考形式链接示例

代码：

1
2
3
4
不懂的问题可以去[百度][1]、[谷歌][2]或者[必应][3]搜索解决方案。
[1]: http://baidu.com "baidu"
[2]: http://google.com "google"
[3]: http://bing.com "bing"

效果：

不懂的问题可以去百度、谷歌或者必应搜索解决方案。

tilte 属性是选择性的，链接名称可以用字母、数字和空格，但是不分大小写。

自动链接

Markdown支持比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用方括号包起来，Markdown就会自动把它转成链接，链接的文字就和链接位置一样，例如：

代码：

1
<http://drzorm.github.io/>

效果：

http://drzorm.github.io/

自动邮箱链接

自动的邮件链接也很类似，只是Markdown会先做一个编码转换的过程，把文字自负转换成 16 进位码的HTML实体，这样的格式可以混淆一些不好的信箱地址收集机器人，例如：

代码：

1
<drzorm@gmail.com>

效果：

drzorm@gmail.com

图片

图片的语法和链接很像。

行内形式（title是选择性的）：

代码：

1
![alt 属性](http://drzorm.github.io/img/author.gif "title属性")

效果：

alt 属性

参考形式：

代码：

1
2
![alt 属性][id]
[id]: http://drzorm.github.io/img/author.gif "title属性"

效果：

alt 属性

程序代码

在一般的段落文字中，你可以使用反引号 ` 来标记代码区段，区段内的 & 、 < 、 > 都会被自动的转换成HTML实体，这项特性让你可以很容易在代码区段内插入HTML码，建立一个已经格式化好的代码区块，只要每行都缩进 4 个空格或是一个 tab 就可以了，而 & 、 < 和 > 也一样会自动转换成HTML实体。

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

代码：

1
Use the `printf()` function.

效果：

Use the printf() function.

如果要在程序代码区段内插入反引号，可以使用多个反引号来开启和结束程序代码区段：

代码：

1
``This is a literal backtick (`) here.``

效果：

This is a literal backtick (`) here.

程序代码区段的起始和结束端都可以放入一个空白，起始端后面一个，结束段前面一个，这样就可以在区段的一开始就插入反引号：

代码：

1
2
3
A single backtick in a code span: `` ` ``

A backtike-delimited string in a code span: `` `foo` ``

效果：

A single backtick in a code span: `

A backtike-delimited string in a code span: `foo`

转义字符

Markdown可以利用反斜杠来插入一些在语法中有其他意义的符号。

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

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

代码：

1
\*文字前后插入普通的星号或底线时需要用反斜杠\*

效果：

*文字前后插入普通的星号或底线时需要用反斜杠*

其他补充

代码：

1
2
3
4
5
6
7
8
9
10
11
12
单个回车
视为空格。

连续回车

视为分段。

行尾加两个空格，这里->  
即可段内换行。

---
上面是分割线

效果：

单个回车
视为空格。

连续回车

视为分段。

行尾加两个空格，这里->
即可段内换行。

上面是分割线