首页 > 清河洛 > Markdown中的区块引用和列表
2018
05-08

Markdown中的区块引用和列表

区块引用Blockquotes

Markdown标记区块引用是使用类似email中用>的引用方式。在每行的最前面加上> :

> 这是第一个区块引用,

> 这是区块引用,跟上面一句在显示中并没有换行,为一个段落。

>

> 这是第二个区块引用,

> 这是区块引用,跟上面一句在显示中并没有换行,为一个段落。

Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :

> 这是第一个区块引用,这是区块引用,跟上面一句在显示中并没有换行,为一个段落。

> 这是第二个区块引用,这是区块引用,跟上面一句在显示中并没有换行,为一个段落。

区块引用可以嵌套(引用内的引用),只要根据层次加上不同数量的 > :

> This is the first level of quoting.

>

> > This is nested blockquote.

>

> Back to the first level.

引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:

> ## 这是一个标题。

>

> 1. 这是第一行列表项。

> 2. 这是第二行列表项。

 

列表

Markdown支持有序列表和无序列表。

无序列表使用星号、加号或是减号作为列表标记:

* Red

* Green

* Blue

等同于:

+ Red

+ Green

+ Blue

也等同于:

- Red

- Green

- Blue

有序列表则使用数字接着一个英文句点:

1. Bird

2. McHale

3. Parish

很重要的一点是,你在列表标记上使用的数字并不会影响输出的 HTML 结果,上面的列表所产生的 HTML 标记为:

<ol>

<li>Bird</li>

<li>McHale</li>

<li>Parish</li>

</ol>

如果你的列表标记写成:

1. Bird

1. McHale

1. Parish

或甚至是:

3. Bird

1. McHale

8. Parish

你都会得到完全相同的 HTML 输出。重点在于,你可以让 Markdown 文件的列表数字和输出的结果相同,或是你懒一点,你可以完全不用在意数字的正确性。

如果你使用懒惰的写法,建议第一个项目最好还是从 1. 开始,因为 Markdown 未来可能会支持有序列表的 start 属性。

列表项目标记通常是放在最左边,但是其实也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符

如果列表项目间用空行分开,在输出 HTML 时 Markdown 就会将项目内容用 <p> 标签包起来,举例来说:

* Bird

* Magic

会被转换为:

<ul>

<li>Bird</li>

<li>Magic</li>

</ul>

但是这个:

* Bird

* Magic

会被转换为:

<ul>

<li><p>Bird</p></li>

<li><p>Magic</p></li>

</ul>

列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符:

1. 这是一个列表第一个.

这是上面列表中的第二个p段落,这句话开始要有一个缩进。

2. 这是一个列表第二个.

如果你每行都有缩进,看起来会看好很多,当然,如果你很懒惰,Markdown 也允许:

如果要在列表项目内放进引用,那 > 就需要缩进:

* A list item with a blockquote:

    > This is a blockquote

    > inside a list item.

如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:

* 一列表项包含一个列表区块:

        <代码写在这>

当然,项目列表很可能会不小心产生,像是下面这样的写法:

1986. What a great season.

换句话说,也就是在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠转义。

1986\. What a great season.

最后编辑:
作者:qingheluo
这个作者貌似有点懒,什么都没有留下。