跳至主要内容

Markdown 語法全攻略

FreeBSD Archlinux Photon_OS Oracle_linux WSL Docker

提示

很久以前當我剛開始寫Blog的時候,曾經把我常用的語法整理過一遍(找不到了),但是最近看到一些騷操作就想拿出來獨立整理一篇

過去在撰寫技術部落格（如 Docusaurus、Obsidian 或 Typora）時，Markdown 是記錄筆記與知識庫的核心語法。除了標準的排版規範外，透過混搭 HTML 標籤可以實現許多進階的視覺效果。本篇將完整梳理從基礎語法到進階 HTML 技巧。

一、 基礎語法篇 (Basic Syntax)​

現代 Markdown 編輯器（如 Typora）多數支援即時預覽與快捷鍵，但掌握原生標記能確保在任何 Wiki 平台上都能完美渲染。

1. 標題文字 (Headings)​

對應 HTML 的 <h1> 至 <h6>，共有六種尺寸階層：

# H1 標題

## H2 標題​

### H3 標題​

#### H4 標題​

##### H5 標題​
###### H6 標題​

2. 分隔線 (Dividers)​

可使用三個以上的星號、減號或加號來建立水平分隔線：

---
***
+++

標準的錨點文字與網址連結寫法：

[標題](http網址)

效果： Kiwi's Wiki

4. 文字效果 (Text Styles)​

支援斜體、粗體、刪除線及其混合搭配：

語法1語法2效果
*斜體*_斜體_斜體
*粗體*_粗體_粗體
*粗斜體*_粗斜體_粗斜體
~刪除~刪除

5. 列表 (Lists)​

  • 無序清單（使用 *、- 或 + 效果完全相同）：

     * 第一項
     * 第二項
     * 第三項

  • 有序清單：

     1. 第一項
     2. 第二項
     3. 第三項

    (註：數字編號即使顛倒，多數編輯器也會自動正確排序)

6. 圖片與多媒體連結​

  • 一般圖片：

     ![Alt text](/path/to/img.jpg)

  • 巢狀影音連結（例如將 YouTube 縮圖包裝成可點擊的超連結）：

     [![影片標題](http://img.youtube.com/vi/SlzBMJvtGHo/0.jpg)](https://www.youtube.com/watch?v=SlzBMJvtGHo "影片提示")

    效果(如youtube範例) Dr.Berg的斷食說明

二、 進階使用篇：Markdown 混搭 HTML 騷操作​

Markdown 的核心設計允許直接嵌入 HTML 語法。當需要更精細的排版、顏色控制或特殊標記時，可以將 HTML 標籤包覆在 Markdown 中。

⚠️ 注意事項： 當在 <> 標籤內使用 HTML 語法時，內部結構建議全面採用 HTML 格式（例如用 <font> 或 <del> 代替 **），避免解析器發生衝突。

1. 文字裝飾與底線​

Markdown 原生並未直接支援底線（避免與超連結混淆），需透過 HTML 的 <u> 標籤實現：

語法效果
<u>底線</u>底線
<del>刪除</del>刪除

2. 自訂字體顏色 (<font>)​

透過 <font color="..."> 可以自由改變字體顏色，適合在技術筆記中標註重點：

語法顯示結果語法顯示結果
<font color="#800000">酒紅色</font>酒紅色<font color="#FF0000">紅色</font>紅色
<font color="#FF6600">橘色</font>橘色<font color="#FFD700">金色</font>金色
<font color="#FFFF00">黃色</font>黃色<font color="#00FF00">綠色</font>綠色
<font color="#008000">墨綠色</font>墨綠色<font color="#00FFFF">青色</font>青色
<font color="#0000FF">深藍色</font>深藍色<font color="#FF00FF">粉紅色</font>粉紅色
<font color="#800080">紫色</font>紫色<font color="#808080">灰色</font>灰色

3. 上標與下標 (<sup> / <sub>)​

適合用於數學公式、化學式或版本標示：

語法效果
3<sup>2</sup>=932=9
H<sub>2</sub>OH2O

4. 特殊數學與常用符號實體​

透過 HTML 實體代碼（Entity References）直接插入特殊符號：

目標語法效果
商標&reg;商標®
函數 ƒ(x)&fnof;(X)=X+1ƒ(X)=X+1
根號&radic;2√2
度數45&deg;45°

5. 漢字注音標示 (<ruby>)​

利用 HTML5 的 <ruby>、<rt>（注音/拼音）與 <rp>（相容不支援瀏覽器的括號）標籤來製作注音夾註：

<ruby>
注<rp>(</rp><rt>ㄓㄨˋ</rt><rp>)</rp>
音<rp>(</rp><rt>ㄧㄣˉ</rt><rp>)</rp>
</ruby>

效果： 注(ㄓㄨˋ)音(ㄧㄣˉ)

實戰應用範例（技術搞笑混搭）： 可在註記中結合色彩與刪除線，打造雙層語意：

我很喜歡 <ruby><font color="blue"><del>我家的艦隊</del></font><rp>(</rp><rt><font color="red">VMware ESXi</font></rt><rp>)</rp></ruby>

效果： 我很喜歡 我家的艦隊(VMware ESXi)

參考文獻

西灣筆記 馬力歐的部落格