2026年4月3日 星期五

Markdown -輕量級的標記語言

 Markdown 是一種由 John Gruber 於 2004 年創建的輕量級標記語言,其核心設計理念是「易讀易寫」。它允許使用者使用簡單的純文字符號來排版,並能輕鬆轉換為結構化的 HTML 文檔。

以下是針對 Markdown 的完整介紹與使用說明:

一、 為什麼要使用 Markdown?

  • 可攜性與永不過時:Markdown 檔案本質上是純文字(.md),任何作業系統或裝置在幾十年後都能開啟,不會有格式跑掉或版本相容性問題。
  • 專注於內容結構:與 Word 不同,Markdown 強調文檔的邏輯結構而非排版樣式,避免了在寫作時被複雜的工具列干擾。
  • 廣泛支援:目前 GitHub、Notion、Discord、Reddit、Obsidian 以及許多技術部落格都原生支援 Markdown。

二、 核心語法教學

掌握以下 7 個基礎規則,即可處理 90% 的寫作需求:

1. 標題 (Headers)

在文字前加上 # 號,並保留一個空格。# 的數量代表標題等級,支援 1 到 6 階。

  • # 一級標題 (對應 HTML 的 <h1>)
  • ## 二級標題
  • ###### 六級標題

2. 強調文字 (Emphasis)

  • 粗體:使用兩個星號 **文字** 或底線 __文字__。
  • 斜體:使用一個星號 *文字* 或底線 _文字_。
  • ~~刪除線~~:使用兩個波浪號 ~~文字~~(屬於 GFM 擴展語法)。

3. 清單 (Lists)

  • 無序清單:使用 *、+ 或 - 開頭。
  • 有序清單:使用數字加上英文句點,如 1.。
  • 任務列表 (CheckBox):使用 - [ ] 表示未完成,- [x] 表示已完成。

4. 連結與圖片 (Links & Images)

  • 連結:[顯示文字](網址)。
  • 圖片:與連結語法相似,但開頭多一個驚嘆號 ![替代文字](圖片路徑或網址)。

5. 程式碼 (Code)

  • 行內程式碼:使用單反引號 `code` 包圍文字。
  • 程式碼區塊:使用三個反引號 包圍多行程式碼,並可在開頭標註語言名稱(如 py 或 js)以實現語法高亮。

6. 引用 (Blockquotes)

在每行開頭加上大於符號 >,常用於引用他人的話或強調重點。

7. 分隔線 (Horizontal Rules)

在單獨一行中使用三個以上的星號 ***、減號 --- 或底線 ___。


三、 進階與特殊語法

許多平台(如 GitHub 或 HackMD)支援額外的擴展語法:

  • 表格 (Tables):使用 | 分隔欄位,並用 - 建立標頭與內容的分隔線。
    | 標題 | 內容 |
    | ---- | ---- |
    | A    | B    |
    
  • 數學公式 (MathJax):使用單個 $ 包圍行內公式(如 $E=mc^2$),或雙個 $$ 包圍獨立公式區塊。
  • 註腳 (Footnotes):使用 [^1] 建立標記,並在文檔末尾定義 [^1]: 這是說明。

四、 常見錯誤與最佳實踐

  1. 忘記空行:段落與段落、標題與段落之間必須有空行,否則內容會黏在一起。
  2. 語法中的空格:強調符號(如 **)必須緊貼文字,不能有空格(例如 ** 錯誤 ** 是無效的)。
  3. 圖片驚嘆號:初學者常忘記圖片語法開頭的 !,導致圖片變成一般的連結。
  4. 轉義字元:如果你想顯示 Markdown 的特殊符號(如 *),請在符號前加上反斜線 \*。

五、 推薦工具

  • 編輯器:
    • Typora:所見即所得,打字時即時顯示渲染效果。
    • VS Code:搭配內建預覽功能,適合開發者。
    • Obsidian:適合建立個人知識庫,具備強大的連結功能。
  • 線上平台:
    • HackMD:強大的協作功能與特殊語法支援。
    • Dillinger:不需安裝,在瀏覽器即可直接撰寫與預覽。

沒有留言:

張貼留言