本篇教學將介紹如何在 Markdown 中建立清單。
在已知的世界裡,有兩種類型的清單:無序清單及有序清單。用白話的方式解釋,前者就是以項目符號標記的,而後者是以數字標記的清單。
要建立無序清單,你需要以星號 ( *
) 做為每個項目的開頭,而且每個項目必須佔一行。比方說,要以 Markdown 書寫採買的清單,看起來會是:
* 牛奶 * 雞蛋 * 鮭魚 * 奶油
這份 Markdown 清單會以符號標記項目的方式呈現:
在下方的文字框,將那些以逗號分隔的文字,改以清單呈現。
以上就是撰寫無序清單的方法,那麼接下來介紹有序清單。
有序清單的項目是以數字開頭,而非星號。我們來看看這份食譜:
用 Markdown 怎麼寫呢?你要這樣做:
1. 打三顆蛋 2. 倒一加侖的牛奶到碗裡 3. 用力地將奶油抹在鮭魚上 4. 將鮭魚放進這碗蛋液及牛奶的混和液體裡
很簡單對不對?十分直覺。
在下方的文字框,以有序清單將剩下的食譜完成。
讚啦!
和你想的一樣,清單的項目中也可以有粗體、斜體字,甚至是連結。在下方的文字框,將植物的學名變成斜體。
非常好!
有時你發現需要撰寫多層次的清單,也稱作 巢狀清單,這種清單允許一個項目底下還有子項目。別怕,他們的 Markdown 語法都是相同的,你只需要在星號前比上層項目多加 一個空格 來縮排。
例如,為了更鉅細靡遺地描述各個人物,我們在底下的清單中使用了這樣的技巧,讓主要的項目底下還包含子清單。
* Tintin * 記者 * 有一頭蓬蓬的橘頭髮 * 他朋友有世界上最厲害的狗狗 * Haddock * 船長 * 有超酷的鬍子 * 喜歡喝威士忌 * 可能是蘇格蘭人?
這些清單將以這樣的階層呈現
在下方的文字框,將每位角色的特質以多層次清單表示。
厲害吧!雖然你的確可以無限延伸階層,但最多保持在三層比較好,否則看起來會一團亂。
我們還要介紹一個清單的縮排技巧,在撰寫段落的時候很好用。假如撰寫一份清單時,想要對其內容插入一些額外的補充資訊(但不是另一階層的清單),看起來像這樣:
打三顆蛋
打蛋時別弄到周圍了。
如果你 真的 搞砸了,拿條抹布擦乾淨。
倒一加侖的牛奶到碗裡
基本上,遵循上述的要點就對了:別灑出來,但如果發生了,就清理乾淨吧。
用力地將奶油抹在鮭魚上
「用力地」是指嚴格的上下移動。 Julia Child 曾說過:
Up and down and all around, that's how butter on salmon goes.
將鮭魚放進這碗蛋液及牛奶的溶液裡
放鮭魚時,有些事項需要注意:
要撰寫這樣的文本,段落的內容需在項目底下,且該行的行首至少要空一格。上例的清單,在 Markdown 的寫法如下:
1. 打三顆蛋 打蛋時別弄到周圍了。 如果你 _真的_ 搞砸了,拿條抹布擦乾淨。 2. 倒一加侖的牛奶到碗裡 基本上,遵循上述的要點就對了:別灑出來,但如果發生了,就清理乾淨吧。 3. 用力地將奶油抹在鮭魚上 「用力地」是指嚴格的上下移動。 Julia Child 曾說過: > Up and down and all around, that's how butter on salmon goes. 4. 將鮭魚放進這碗蛋液及牛奶的溶液裡 * 確保周圍無障礙物及孩童 * 兩手並用 * 隨時準備一條抹布在旁,將灑出來的液體擦乾淨
注意到前兩個項目,它們底下的段落都各以一個空格開頭。如果你覺得這樣看起來很怪,也可以再鍵入幾個空白字元,將其適當對齊;同後兩個項目一樣。 在這些段落中,你可以插入各種 Markdown 元素,比如引用區塊,甚至是另一份清單!
在下方的文字框,將各子項目改以段落呈現。