Markdown中的区块引用和列表
区块引用Blockquotes
Markdown标记区块引用是使用类似email中用>的引用方式。在每行的最前面加上> :
这是第一个区块引用,
这是区块引用,跟上面一句在显示中并没有换行,为一个段落。
这是第二个区块引用,
这是区块引用,跟上面一句在显示中并没有换行,为一个段落。
Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :
这是第一个区块引用,这是区块引用,跟上面一句在显示中并没有换行,为一个段落。
这是第二个区块引用,这是区块引用,跟上面一句在显示中并没有换行,为一个段落。
区块引用可以嵌套(引用内的引用),只要根据层次加上不同数量的 > :
This is the first level of quoting.
This is nested blockquote.Back to the first level.
引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:
这是一个标题。
- 这是第一行列表项。
- 这是第二行列表项。
列表
Markdown支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记:
- Red
- Green
- Blue
等同于:
- Red
- Green
- Blue
也等同于:
- Red
- Green
- Blue
有序列表则使用数字接着一个英文句点:
- Bird
- McHale
- Parish
很重要的一点是,你在列表标记上使用的数字并不会影响输出的 HTML 结果,上面的列表所产生的 HTML 标记为:
- Bird
- McHale
- Parish
如果你的列表标记写成:
- Bird
- McHale
- Parish
或甚至是:
- Bird
- McHale
- Parish
你都会得到完全相同的 HTML 输出。重点在于,你可以让 Markdown 文件的列表数字和输出的结果相同,或是你懒一点,你可以完全不用在意数字的正确性。
如果你使用懒惰的写法,建议第一个项目最好还是从 1. 开始,因为 Markdown 未来可能会支持有序列表的 start 属性。
列表项目标记通常是放在最左边,但是其实也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符。
如果列表项目间用空行分开,在输出 HTML 时 Markdown 就会将项目内容用 标签包起来,举例来说:
- Bird
- Magic
会被转换为:
- Bird
- Magic
但是这个:
- Bird
- Magic
会被转换为:
- Bird
- Magic
列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符:
- 这是一个列表第一个.
这是上面列表中的第二个p段落,这句话开始要有一个缩进。
- 这是一个列表第二个.
如果你每行都有缩进,看起来会看好很多,当然,如果你很懒惰,Markdown 也允许:
如果要在列表项目内放进引用,那 > 就需要缩进:
A list item with a blockquote:
This is a blockquote
inside a list item.
如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:
一列表项包含一个列表区块:
<代码写在这>
当然,项目列表很可能会不小心产生,像是下面这样的写法:
- What a great season.
换句话说,也就是在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠转义。
1986. What a great season.