Markdown语法说明详解(3)

要让列表看起来更漂亮,可以把内容用固定的缩排整理好:

* Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. * Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

但是如果你很懒,那也不一定需要:

* Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. * Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

如果列表项目间用空行分开, 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 个空白或是一个 tab :

1. This is a list item with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. Donec sit amet nisl. Aliquam semper ipsum sit amet velit. 2. Suspendisse id sem consectetuer libero luctus adipiscing.

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

* This is a list item with two paragraphs. This is the second paragraph in the list item. You're only required to indent the first line. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. * Another item in the same list.

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

* A list item with a blockquote: > This is a blockquote > inside a list item.

如果要放程序代码区块的话,该区块就需要缩排两次,也就是 8 个空白或是两个 tab:

* A list item with a code block: <code goes here>

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

1986. What a great season.

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

1986\. What a great season. 程序代码区块

和程序相关的写作或是标签语言原始代码通常会有已经排版好的程序代码区块,通常这些区块我们并不希望它以一般段落文档的方式去排版,而是照原来的样子显示,Markdown 会用 <pre> 和 <code> 标签来把程序代码区块包起来。

要在 Markdown 中建立程序代码区块很简单,只要简单地缩排 4 个空白或是 1 个 tab 就可以,例如,下面的输入:

This is a normal paragraph: This is a code block.

Markdown 会转换成:

<p>This is a normal paragraph:</p> <pre><code>This is a code block. </code></pre>

这个每行一级的缩排(4 个空白或是 1 个 tab),都会被移除,例如:

Here is an example of AppleScript: tell application "Foo" beep end tell

会被转换为:

<p>Here is an example of AppleScript:</p> <pre><code>tell application "Foo" beep end tell </code></pre>

一个程序代码区块会一直持续到没有缩排的那一行(或是文档结尾)。

在程序代码区块里面, & 、 < 和 > 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始代码,只需要复制贴上,再加上缩排就可以了,剩下的 Markdown 都会帮你处理,例如:

<div> &copy; 2004 Foo Corporation </div>

会被转换为:

<pre><code>&lt;div&gt; &amp;copy; 2004 Foo Corporation &lt;/div&gt; </code></pre>

程序代码区块中,一般的 Markdown 语法不会被转换,像是星号便只是星号,这表示你可以很容易地以 Markdown 语法撰写 Markdown 语法相关的文档。

分隔线

你可以在一行中用三个或以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号中间插入空白。下面每种写法都可以建立分隔线:

* * * *** ***** - - - --------------------------------------- 区段元素 链接

Markdown 支持两种形式的链接语法: 行内和参考两种形式。

不管是哪一种,链接的文字都是用 [方括号] 来标记。

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/13224.html