目錄#

• 基本概念與使用方式
• 標題（Headers）
• 段落與換行
• 粗體、斜體、刪除線
• 清單（Lists）
  • 無序清單
  • 有序清單
• 連結與圖片
  • 連結
  • 圖片
• 程式碼：行內與區塊
  • 行內程式碼
  • 程式碼區塊
• 引言與分隔線
  • 引言（Quote）
  • 分隔線（Horizontal Rule）
• 表格（Tables）
• 腳註（Footnotes）
• 數學公式（Math）
• 轉義字元（Escaping）
• Fuwari 特色
  • GitHub Repository Cards（GitHub 倉庫卡片）
  • Admonitions（提示框）
    • 基本語法
    • 自訂標題
    • GitHub 風格的提示語法
• pg72.tw 特色
  • 連結方塊
  • 分項介紹：

Markdown 是一種「輕量級標記語言」，讓你用純文字就能寫出有標題、清單、表格、程式碼區塊的文件，讀起來也很直覺。

它廣泛用在 GitHub README、技術文件、筆記工具（Obsidian、HackMD）、部落格文章、通訊平台（Discord）等地方。

本篇文章主要以 Fuwari 平台提供之用法作補充，裡面會用到許多基本用法，一樣也是可以參考的喔！

基本概念與使用方式#

• 你在 .md 檔裡打的就是普通文字，加上一些符號（例如 #、*、[]()）讓系統知道要怎麼排版。
• 重點是：就算「不轉成網頁」，原始檔本身也要 好讀，這是 Markdown 的設計目標。

標題（Headers）#

用 # 開頭代表標題，# 越多層級越小，從 H1 到 H6。

這是一級標題（H1）#

1
# 這是一級標題（H1）
2
## 這是二級標題（H2）
3
### 這是三級標題（H3）
4
#### 這是四級標題（H4）
5
##### 這是五級標題（H5）

段落與換行#

• 段落與段落之間「空一行」就是新的段落。
• 如果要在同一段裡強制換行，可以在行尾加兩個空白再按 Enter（有些編輯器也接受直接換行）。

1
這是第一段。
2

3
這是第二段。
4

5
這是同一段中的第一行
6
這是同一段中的第二行

粗體、斜體、刪除線#

用 * 或 _ 包住文字即可，兩個是等效寫法。

1
**粗體文字** 或 __粗體文字__
2

3
*斜體文字* 或 _斜體文字_
4

5
~~刪除線~~

清單（Lists）#

1
- 第一項
2
  - 第一項第一款
3
  - 第一項第二款
4
- 第二項
5
- 第三項

1
1. 步驟一
2
2. 步驟二
3
3. 步驟三

連結與圖片#

語法非常像，只是圖片多一個 !。

1
[顯示文字](https://example.com)
2

3
[Google](https://www.google.com)
4

5
[跳到特定標題](#標題名稱)

1
![替代文字](https://example.com/image.jpg)

程式碼：行內與區塊#

1
請輸入 `npm install` 然後按下 Enter。

1
```python
2
def hello():
3
    print("Hello, Markdown!")
4
\```

1
這是一段普通文字。
2

3
    # 這一行開始縮排 4 格
4
    for i in 1 .. 10 { do-something(i) }

1
# 這一行開始縮排 4 格
2
for i in 1 .. 10 { do-something(i) }

引言與分隔線#

1
> 這是一段引用文字
2
> 可以有第二行
3

4
>> 這是巢狀引用

1
---
2

3
***
4

5
___

表格（Tables）#

表格用 | 加 - 來排出欄位與對齊方式。

1
| 品項 | 價格 | 備註     |
2
| ---- | ---- | -------- |
3
| 蘋果 | 10   | 好吃     |
4
| 香蕉 | 15   | 需要冰   |

腳註（Footnotes）#

腳註可以讓你在內文加註補充說明，又不會打斷閱讀節奏。
寫法是先在內文標註，再到文章底部定義這個註腳內容。

1
這是一段文字，其中有一個需要補充說明的地方[^1]。
2

3
[^1]: 這裡是腳註的內容，會被排在文章底部。

讀者在頁面上會看到小小的註腳編號，可以點回去跳轉。

數學公式（Math）#

原始範例也示範了數學公式的寫法：

• 行內數學：$\\omega = d\\phi / dt$。
• 區塊數學：用 $$ ... $$ 包起來，裡面可以寫 LaTeX 方程式。

1
行內公式長這樣：$\\omega = d\\phi / dt$。
2

3
$$
4
I = \\int \\rho R^{2} dV
5
$$

要注意的是：

• 純 Markdown 並不會自動顯示漂亮的公式，通常需要額外安裝 KaTeX / MathJax 或對應的 Astro 外掛才會真的渲染成數學式。

轉義字元（Escaping）#

當你想「顯示符號本身」而不是觸發 Markdown 語法時，可以在前面加一個 \。
例如：想要顯示星號，而不是變成粗體 / 斜體。[][][][][]

1
\*這裡不會變成斜體\*，而是顯示星號。
2

3
\`foo\` 會顯示成 `foo`，而不是被當成程式碼。

這在寫教學文、要示範語法本身時非常實用。

Fuwari 特色#

1
:spoiler[你想要藏起來的字]

1
::github{repo="擁有者名稱/倉庫名稱"}

1
::github{repo="saicaca/fuwari"}

1
:::note
2
這裡是一般資訊的小提醒。
3
:::
4

5
:::tip
6
這裡是讓你更順利完成操作的小技巧。
7
:::

1
:::note[我的自訂標題]
2
這是一個有自訂標題的 note 提示框。
3
:::

1
> [!NOTE]
2
> The GitHub syntax is also supported.
3

4
> [!TIP]
5
> The GitHub syntax is also supported.

pg72.tw 特色#

1
::link{url="https://pg72.tw/posts/markdown-note/" text="Markdown筆記" icon="https://pg72.tw/avatar.png"}