June 30, 2021 by Yi Lee

Markdown 語法學習

blog-feature-image

每篇文章的最開頭,需寫入以下程式碼,方能順利顯示在Hugo的網頁上

Markedown語法包含以下格式。Markdown語法無法改變顏色,但可以做以下變化

1. 內文: 直接打內容

2. 標題: 前面加上一個#變成一級標題 兩個#變成二級標題

以此類推 支援到六級標題 示範如下

以此類推 支援到六級標題 示範如下

一級標題

二級標題

三級標題

四級標題

五級標題
六級標題

3. 粗體: 在需要加粗的文字前後加上兩個**,格式會變成**加粗文字**

**加粗文字範例**與無加粗文字比較

4. 斜體: 在需要變成斜體的文字前後加上一個*,格式會變成*斜體文字*,粗體斜體無法同時使用

 *斜體文字範例*與無斜體文字比較

5. 有序序列: 在想要變成序列的文字前方打上1.和一空白鍵,第二點前方可以打上2.和一空白鍵或1.和一空白鍵,語法會直接變成有序序列,範例如下

  1. 這是第一點
  2. 這是第二點

6. 無序序列: 在想要變成序列的文字前方打上*和一空白鍵,第二點前方可以打上2.和一空白鍵或1.和一空白鍵,會變成無序序列,範例如下

  • 第一個無序序列
  • 第二個無序序列

有序序列與無序序列若想要加層級 每一個層級換行後額外加上四個空白鍵即可產生縮排效果 示範如下

  1. 這是第一個層級第一項

    • 這是第二個層級第一項

    • 這是第二個層級第二項

      • 這是第三個層級第一項
      • 這是第三個層級第二項
  2. 這是第二個層級第一項

7. 引用: 在引用的文字前方打上>和一空白鍵,會顯示成引用文字,範例如下

以下是一段引用文字

8. 超連結: 使用方式是在一對中括號[]裡面打上想要呈現的文字,緊跟著一對小括號()裡面打上超連結的位置,範例如下

我是超連結

若是超連結是連到網站內頁,語法格式與上述相同,惟須注意小括號裡面的格式是/加上資料夾名稱加上/加上檔案名稱,不含副檔名, 範例如下

我是連回blog其他文章的超連結

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編輯

Typora載點

comments powered by Disqus