注册 登录

清河洛

Markdown中的区块引用和列表

qingheluo2018-05-08清河洛493
区块引用BlockquotesMarkdown标记区块引用是使用类似email中用>的引用方式。在每行的最前面加上> :这是第一个区块引用,这是区块引用,跟上面一句在显示中并没有换行,为一个段落。这是第二个区块引用,这是区块引用,跟上面一句在显示中并没有换行,为一个段落。Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :这是第一个区块引用,这是区块引用,跟上面一句在显示中并没有换行,为一个段落。这是第二个区块引用,这是区块引用,跟上面一句在显示中并没有换行,为一个段落。区块引用可以嵌套(引用内的引用),只要根据层次加上不同数量的 > :This ...

区块引用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 标记为:

  1. Bird
  2. McHale
  3. Parish

如果你的列表标记写成:

  1. Bird
  2. McHale
  3. Parish

或甚至是:

  1. Bird
  2. McHale
  3. Parish

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

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

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

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

  • Bird
  • Magic

会被转换为:

  • Bird
  • Magic

但是这个:

  • Bird
  • Magic

会被转换为:

  • Bird
  • Magic

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

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

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

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

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

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

  • A list item with a blockquote:

    This is a blockquote

    inside a list item.

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

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

      <代码写在这>
    

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

  1. What a great season.

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

1986. What a great season.



网址导航