清單(Lists)

本篇教學將介紹如何在 Markdown 中建立清單。

在已知的世界裡,有兩種類型的清單:無序清單及有序清單。用白話的方式解釋,前者就是以項目符號標記的,而後者是以數字標記的清單。

要建立無序清單,你需要以星號 ( * ) 做為每個項目的開頭,而且每個項目必須佔一行。比方說,要以 Markdown 書寫採買的清單,看起來會是:

* 牛奶
* 雞蛋
* 鮭魚
* 奶油

這份 Markdown 清單會以符號標記項目的方式呈現:

在下方的文字框,將那些以逗號分隔的文字,改以清單呈現。


以上就是撰寫無序清單的方法,那麼接下來介紹有序清單。

有序清單的項目是以數字開頭,而非星號。我們來看看這份食譜:

  1. 打三顆蛋
  2. 倒一加侖的牛奶到碗裡
  3. 用力地將奶油抹在鮭魚上
  4. 將鮭魚放進這碗蛋液及牛奶的混和液體裡

用 Markdown 怎麼寫呢?你要這樣做:

1. 打三顆蛋
2. 倒一加侖的牛奶到碗裡
3. 用力地將奶油抹在鮭魚上
4. 將鮭魚放進這碗蛋液及牛奶的混和液體裡

很簡單對不對?十分直覺。

在下方的文字框,以有序清單將剩下的食譜完成。


讚啦!

和你想的一樣,清單的項目中也可以有粗體、斜體字,甚至是連結。在下方的文字框,將植物的學名變成斜體。


非常好!

有時你發現需要撰寫多層次的清單,也稱作 巢狀清單,這種清單允許一個項目底下還有子項目。別怕,他們的 Markdown 語法都是相同的,你只需要在星號前比上層項目多加 一個空格 來縮排。

例如,為了更鉅細靡遺地描述各個人物,我們在底下的清單中使用了這樣的技巧,讓主要的項目底下還包含子清單。

* Tintin
 * 記者
 * 有一頭蓬蓬的橘頭髮
 * 他朋友有世界上最厲害的狗狗
* Haddock
 * 船長
 * 有超酷的鬍子
 * 喜歡喝威士忌
   * 可能是蘇格蘭人?

這些清單將以這樣的階層呈現

  • Tintin
    • 記者
    • 有一頭蓬蓬的橘頭髮
    • 他朋友有世界上最厲害的狗狗
  • Haddock
    • 船長
    • 有超酷的鬍子
    • 喜歡喝威士忌
      • 可能是蘇格蘭人?

在下方的文字框,將每位角色的特質以多層次清單表示。


厲害吧!雖然你的確可以無限延伸階層,但最多保持在三層比較好,否則看起來會一團亂。

我們還要介紹一個清單的縮排技巧,在撰寫段落的時候很好用。假如撰寫一份清單時,想要對其內容插入一些額外的補充資訊(但不是另一階層的清單),看起來像這樣:

  1. 打三顆蛋

    打蛋時別弄到周圍了。

    如果你 真的 搞砸了,拿條抹布擦乾淨。

  2. 倒一加侖的牛奶到碗裡

    基本上,遵循上述的要點就對了:別灑出來,但如果發生了,就清理乾淨吧。

  3. 用力地將奶油抹在鮭魚上

    「用力地」是指嚴格的上下移動。 Julia Child 曾說過:

    Up and down and all around, that's how butter on salmon goes.

  4. 將鮭魚放進這碗蛋液及牛奶的溶液裡

    放鮭魚時,有些事項需要注意:

    • 確保周圍無障礙物及孩童
    • 兩手並用
    • 隨時準備一條抹布在旁,將灑出來的液體擦乾淨

要撰寫這樣的文本,段落的內容需在項目底下,且該行的行首至少要空一格。上例的清單,在 Markdown 的寫法如下:

1. 打三顆蛋

 打蛋時別弄到周圍了。
 如果你 _真的_ 搞砸了,拿條抹布擦乾淨。

2. 倒一加侖的牛奶到碗裡

 基本上,遵循上述的要點就對了:別灑出來,但如果發生了,就清理乾淨吧。

3. 用力地將奶油抹在鮭魚上

   「用力地」是指嚴格的上下移動。 Julia Child 曾說過:
   > Up and down and all around, that's how butter on salmon goes.
4. 將鮭魚放進這碗蛋液及牛奶的溶液裡

   * 確保周圍無障礙物及孩童
   * 兩手並用
   * 隨時準備一條抹布在旁,將灑出來的液體擦乾淨
  

注意到前兩個項目,它們底下的段落都各以一個空格開頭。如果你覺得這樣看起來很怪,也可以再鍵入幾個空白字元,將其適當對齊;同後兩個項目一樣。 在這些段落中,你可以插入各種 Markdown 元素,比如引用區塊,甚至是另一份清單!

在下方的文字框,將各子項目改以段落呈現。


現在你已經了解如何以 Markdown 撰寫清單了!

前往下堂課