Markdown语法学习笔记

Markdown 学习笔记

区块元素

一、段落和换行

段落前后要有一个以上的空行。

普通段落不能用空格和制表符来缩进。

段落内强迫换行（插入<br />方法：先按两个以上的空格，再按回车。

二、标题

Markdown 支持两种标题语法：类Setext式和类atx式：

类Setext式是用底线的形式： 用

=

做底线表示最高阶标题，
用

-

做底线表示第二阶标题。
数量不限，多少都可以。 例如：

这是第一阶标题

这是第二阶标题

---

类atx式是在行首插入1-6个

#

，
表示标题的第一阶到第六阶，相当于

h1

-

h6

。
例如：

#这是H1

##这是H2

###这是H3

####这是H4

#####这是H5
######这是H6

三、区块引用Blockquotes

区块引用使用

>

开始，
可以在段落的每一行前都加

>

，
也可以只在段落第一行加，其余行省略。 例如：

这是一个区块引用， 只有一个段落。

有两个段落的话，中间隔个空行。

这是一个区块引用，

我有两个段落。

区块嵌套，使用多个

>

。

这是第一级区块引用

这是第二级

返回第一级

区块引用内也可以使用标题、序列等。

这是一个
标题

这是序列

这是序列

四、列表

分为有序列表（类似

ol

）和无序列表（

ul

）。

有序列表使用数字加英文句点， 注意后面要再一个空格或制表符， 而且数字和显示出来的序号无关。

无序列表使用

*

、

+

或者

-

。

有序列表实例

这是第一条

这是第二条

无序列表实例

中国

美国

列表内使用引用，

>

要缩进。

使用引用

这是列表内的引用

这是引用第二段落

使用引用

五、代码区块

使用代码区块，缩进4个空格或一个制表符。

这是里代码区块

这里还是
这里仍然是
直到没有缩进的那一行

这里就不是了

六、分隔线

在一行内使用3个或以上的

*

、

-

或者

_

。
中间可以有空格 例如：

效果：

代码：

***
- - -
_ _ _ _ _ _ _

区段元素

一、链接

两种链接语法：行内式和参考式

链接文字用方括号标记，如

[链接文字]

行内式：方括号后跟圆括号，圆括号内是链接地址和title。

效果： GitHub 代码：

[GitHub](http://github.com
'GitHub official website')

参考式：

[链接文字][链接标记]

，然后在其它任何地方定义链接标记代表的内容。

链接标记定义格式：

[链接标记]

+

:

+
一个以上的空格或制表符 + 链接网址 + title(可选)

效果： [GitHub][github_url] [github_url]: http://github.com 'GitHub
website'

代码：

[GitHub][github_url]
[github_url]: http://github.com 'GitHub website'

隐式链接标记： 省略链接标记，等同于链接文字

[GitHub][]

[GitHub]: github.com "github.com"

链接标记可以是字母、数字、空白、标点符号，不区分大小写。

自动链接：使用中括号

[]

括起来。链接文字和网址一样。适用电子邮箱。

效果： http://github.com | esinger@qq.com

代码：

<http://github.com>
| <esinger@qq.com>

二、强调

使用一个

*

或

_

包围需要强调的字符，效果等同

em

使用两个

*

或

_

包围需要强调的字符，效果等同

strong

如果

*

和

_

两边都有空白的话，会被当做普通字符

如果使用普通的符号，请在前边加上反斜线

\

效果：

中国 中国 日本 日本 *
中国 *

代码：

*中国* **中国** _日本_ __日本__ * 中国 *

三、区段代码

使用反引号

`

标记区段代码

在代码区段内使用反引号，用多个反引号括起来

代码区段起始端后面和结束端前面都可以有一个空格

引用单个反引号，效果：

`

代码：

`` ` ``

效果：

PHP的字符函数有`substr()`等。

代码：

``PHP的字符函数有`substr()`等。``

四、图片

图片的表示方法和链接差不多，只是前面加一个英文的

!

，把链接文字替换成图片说明（img标签里的alt）

五、反斜杠

使用反斜杠

\

插入有特殊语法意义的符号

支持以下符号：

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

更多更详细的Markdown语法，请参考： Markdown
语法说明 (简体中文版)