|
|
@ -494,8 +494,13 @@ List markers typically start at the left margin, but may be indented by |
|
|
|
up to three spaces. List markers must be followed by one or more spaces |
|
|
|
up to three spaces. List markers must be followed by one or more spaces |
|
|
|
or a tab. |
|
|
|
or a tab. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
清單項目標記通常是放在最左邊,但是其實也可以縮排,最多三個空白,項目標記後面 |
|
|
|
|
|
|
|
則一定要接著至少一個空白或 tab。 |
|
|
|
|
|
|
|
|
|
|
|
To make lists look nice, you can wrap items with hanging indents: |
|
|
|
To make lists look nice, you can wrap items with hanging indents: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
要讓清單看起來更漂亮,你可以把內容用固定的縮排整理好: |
|
|
|
|
|
|
|
|
|
|
|
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit. |
|
|
|
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit. |
|
|
|
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, |
|
|
|
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, |
|
|
|
viverra nec, fringilla in, laoreet vitae, risus. |
|
|
|
viverra nec, fringilla in, laoreet vitae, risus. |
|
|
@ -504,6 +509,8 @@ To make lists look nice, you can wrap items with hanging indents: |
|
|
|
|
|
|
|
|
|
|
|
But if you want to be lazy, you don't have to: |
|
|
|
But if you want to be lazy, you don't have to: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
但是如果你很懶,那也不一定需要: |
|
|
|
|
|
|
|
|
|
|
|
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit. |
|
|
|
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit. |
|
|
|
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, |
|
|
|
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, |
|
|
|
viverra nec, fringilla in, laoreet vitae, risus. |
|
|
|
viverra nec, fringilla in, laoreet vitae, risus. |
|
|
@ -513,11 +520,16 @@ But if you want to be lazy, you don't have to: |
|
|
|
If list items are separated by blank lines, Markdown will wrap the |
|
|
|
If list items are separated by blank lines, Markdown will wrap the |
|
|
|
items in `<p>` tags in the HTML output. For example, this input: |
|
|
|
items in `<p>` tags in the HTML output. For example, this input: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
如果清單項目間用空行分開, Markdown 會把項目的內容在輸出時用 `<p>` |
|
|
|
|
|
|
|
標籤包起來,舉例來說: |
|
|
|
|
|
|
|
|
|
|
|
* Bird |
|
|
|
* Bird |
|
|
|
* Magic |
|
|
|
* Magic |
|
|
|
|
|
|
|
|
|
|
|
will turn into: |
|
|
|
will turn into: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
會被轉換為: |
|
|
|
|
|
|
|
|
|
|
|
<ul> |
|
|
|
<ul> |
|
|
|
<li>Bird</li> |
|
|
|
<li>Bird</li> |
|
|
|
<li>Magic</li> |
|
|
|
<li>Magic</li> |
|
|
@ -525,12 +537,16 @@ will turn into: |
|
|
|
|
|
|
|
|
|
|
|
But this: |
|
|
|
But this: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
但是這個: |
|
|
|
|
|
|
|
|
|
|
|
* Bird |
|
|
|
* Bird |
|
|
|
|
|
|
|
|
|
|
|
* Magic |
|
|
|
* Magic |
|
|
|
|
|
|
|
|
|
|
|
will turn into: |
|
|
|
will turn into: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
會被轉換為: |
|
|
|
|
|
|
|
|
|
|
|
<ul> |
|
|
|
<ul> |
|
|
|
<li><p>Bird</p></li> |
|
|
|
<li><p>Bird</p></li> |
|
|
|
<li><p>Magic</p></li> |
|
|
|
<li><p>Magic</p></li> |
|
|
@ -540,6 +556,9 @@ List items may consist of multiple paragraphs. Each subsequent |
|
|
|
paragraph in a list item must be indented by either 4 spaces |
|
|
|
paragraph in a list item must be indented by either 4 spaces |
|
|
|
or one tab: |
|
|
|
or one tab: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
清單項目可以包含多個段落,每個項目下的端落都必須要縮排 4 個空白或 |
|
|
|
|
|
|
|
是一個 tab : |
|
|
|
|
|
|
|
|
|
|
|
1. This is a list item with two paragraphs. Lorem ipsum dolor |
|
|
|
1. This is a list item with two paragraphs. Lorem ipsum dolor |
|
|
|
sit amet, consectetuer adipiscing elit. Aliquam hendrerit |
|
|
|
sit amet, consectetuer adipiscing elit. Aliquam hendrerit |
|
|
|
mi posuere lectus. |
|
|
|
mi posuere lectus. |
|
|
@ -554,6 +573,9 @@ It looks nice if you indent every line of the subsequent |
|
|
|
paragraphs, but here again, Markdown will allow you to be |
|
|
|
paragraphs, but here again, Markdown will allow you to be |
|
|
|
lazy: |
|
|
|
lazy: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
如果你每行都有縮排,看起來會看好很多,當然,再次的,如果你很懶惰, |
|
|
|
|
|
|
|
Markdown 也允許: |
|
|
|
|
|
|
|
|
|
|
|
* This is a list item with two paragraphs. |
|
|
|
* This is a list item with two paragraphs. |
|
|
|
|
|
|
|
|
|
|
|
This is the second paragraph in the list item. You're |
|
|
|
This is the second paragraph in the list item. You're |
|
|
@ -565,6 +587,8 @@ lazy: |
|
|
|
To put a blockquote within a list item, the blockquote's `>` |
|
|
|
To put a blockquote within a list item, the blockquote's `>` |
|
|
|
delimiters need to be indented: |
|
|
|
delimiters need to be indented: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
如果要在清單項目內放進引言,那 `>` 就需要縮排: |
|
|
|
|
|
|
|
|
|
|
|
* A list item with a blockquote: |
|
|
|
* A list item with a blockquote: |
|
|
|
|
|
|
|
|
|
|
|
> This is a blockquote |
|
|
|
> This is a blockquote |
|
|
@ -573,6 +597,9 @@ delimiters need to be indented: |
|
|
|
To put a code block within a list item, the code block needs |
|
|
|
To put a code block within a list item, the code block needs |
|
|
|
to be indented *twice* -- 8 spaces or two tabs: |
|
|
|
to be indented *twice* -- 8 spaces or two tabs: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
如果要放程式碼區塊的話,該區塊就需要縮排 *兩次* ,也就是 8 個 |
|
|
|
|
|
|
|
空白或是兩個 tab: |
|
|
|
|
|
|
|
|
|
|
|
* A list item with a code block: |
|
|
|
* A list item with a code block: |
|
|
|
|
|
|
|
|
|
|
|
<code goes here> |
|
|
|
<code goes here> |
|
|
@ -581,11 +608,16 @@ to be indented *twice* -- 8 spaces or two tabs: |
|
|
|
It's worth noting that it's possible to trigger an ordered list by |
|
|
|
It's worth noting that it's possible to trigger an ordered list by |
|
|
|
accident, by writing something like this: |
|
|
|
accident, by writing something like this: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
當然,項目清單很可能會不小心產生,像是下面這樣的寫法: |
|
|
|
|
|
|
|
|
|
|
|
1986. What a great season. |
|
|
|
1986. What a great season. |
|
|
|
|
|
|
|
|
|
|
|
In other words, a *number-period-space* sequence at the beginning of a |
|
|
|
In other words, a *number-period-space* sequence at the beginning of a |
|
|
|
line. To avoid this, you can backslash-escape the period: |
|
|
|
line. To avoid this, you can backslash-escape the period: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
換句話說,也就是在行首出現 *數字-句點-空白* ,要避免這樣的狀況,你 |
|
|
|
|
|
|
|
可以在句點前面加上反斜線。 |
|
|
|
|
|
|
|
|
|
|
|
1986\. What a great season. |
|
|
|
1986\. What a great season. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|