June 30, 2021 by Yi Lee
Markdown 語法學習
每篇文章的最開頭,需寫入以下程式碼,方能順利顯示在Hugo的網頁上
Markedown語法包含以下格式。Markdown語法無法改變顏色,但可以做以下變化
1. 內文: 直接打內容
2. 標題: 前面加上一個#變成一級標題 兩個#變成二級標題
以此類推 支援到六級標題 示範如下
以此類推 支援到六級標題 示範如下
一級標題
二級標題
三級標題
四級標題
五級標題
六級標題
3. 粗體: 在需要加粗的文字前後加上兩個**,格式會變成**加粗文字**
**加粗文字範例**與無加粗文字比較
4. 斜體: 在需要變成斜體的文字前後加上一個*,格式會變成*斜體文字*,粗體斜體無法同時使用
*斜體文字範例*與無斜體文字比較
5. 有序序列: 在想要變成序列的文字前方打上1.和一空白鍵,第二點前方可以打上2.和一空白鍵或1.和一空白鍵,語法會直接變成有序序列,範例如下
- 這是第一點
- 這是第二點
6. 無序序列: 在想要變成序列的文字前方打上*和一空白鍵,第二點前方可以打上2.和一空白鍵或1.和一空白鍵,會變成無序序列,範例如下
- 第一個無序序列
- 第二個無序序列
有序序列與無序序列若想要加層級 每一個層級換行後額外加上四個空白鍵即可產生縮排效果 示範如下
-
這是第一個層級第一項
-
這是第二個層級第一項
-
這是第二個層級第二項
- 這是第三個層級第一項
- 這是第三個層級第二項
-
-
這是第二個層級第一項
7. 引用: 在引用的文字前方打上>和一空白鍵,會顯示成引用文字,範例如下
以下是一段引用文字
8. 超連結: 使用方式是在一對中括號[]裡面打上想要呈現的文字,緊跟著一對小括號()裡面打上超連結的位置,範例如下
若是超連結是連到網站內頁,語法格式與上述相同,惟須注意小括號裡面的格式是/加上資料夾名稱加上/加上檔案名稱,不含副檔名, 範例如下
9. 圖片: 使用方式是先打一個驚嘆號!,緊跟著一對中括號[]和一對小括號()裡面打上圖片的位置,範例如下

10. 單行程式碼: 是可用於內文的程式碼。在一段內文後`,打一對小引號 ,在小引號內打入程式碼,範例如下
這是一段內文,之後緊跟著一行程式碼Hello World
11. 多行程式碼: 多行程式碼無法寫在內文裡,而必須換行書寫。在程式碼前後行各輸入三個小引號,在開頭的小飲號後方可寫語法名稱,多行程式碼即可按該語法的顯示方式顯現,以下是一段python範例
print("Hello world")
print("Hello world")
print("Hello world")
12. 表格: 不好使用,依據|分欄位,換行分列,使用分隔線與冒號,可排版對齊方式,示範如下
| 第一列 | 第二列置中 | 第三列靠左 |
|---|---|---|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
推薦編寫Markdown的編輯器Typora
好處: 所見即所得
缺點: 圖片與Hugo沒有整合的很好
解決方式: 在Typora寫好文字,預留圖片空間,再回到visual studio code編輯