寫文建站文章的 Markdown 與嵌入寫法

Markdown 語法指南

本指南示範 EdgePress 文章支援的 Markdown 功能。原始檔保持易讀，渲染後的 HTML 會先經過淨化再顯示於頁面。

標題與段落

在標題前加上井字號即可設定層級。空白行會開始新的段落。

Heading level three

Heading level four

Heading level five

Heading level six

Setext heading level two

在行尾加入反斜線可以產生硬換行。
這一行仍屬於同一個段落。

分隔線

常見的三種寫法都會產生水平分隔線：

---

---

---

強調與程式碼

可以使用 斜體、粗體 和 刪除線。行內程式碼寫作 npm run build。

const greeting = "Hello, Markdown.";

也可以用波浪線包住程式碼：

This block uses a tilde fence.

每行縮排四個空格也會產生程式碼區塊：

const indented = "four spaces";

使用 ` 可以在程式碼片段中顯示一個反引號。

在程式碼片段中寫 \*，可以示範轉義後的星號。字元參照 < 和 & 會顯示為一般文字。

連結與圖片

行內連結可以指向專案頁面，引用式連結則指向關於頁面。

GFM 會將裸網址自動轉換為連結：https://www.markdownguide.org/ 。尖括號網址、www 網域和電子郵件地址也會自動辨識：https://commonmark.org www.example.com team@example.com。

展示 Markdown 文件如何產生靜態頁面的示意圖

以圖片語法連結 MP4 檔案時，會產生影片播放器：

![戶外錄影](https://media.example.org/field-recording.mp4 "Wind test")

清單與引用

• 清單項目中也可以使用 格式。

  1. 在無序清單中巢狀有序項目。
  2. 再新增一個巢狀項目。

• ✓ 已完成工作會帶有無障礙狀態標籤。

• □ 未完成工作會使用另一種狀態標籤。

區塊引用中可以放入清單：

• 第一個引用項目。
• 第二個引用項目。

區塊引用也可以繼續巢狀。

這是內層引用。

表格與安全 HTML

Syntax	Rendered form
# Heading	A heading
**text**	Strong emphasis

需要時可以使用 Ctrl 這類語意化行內 HTML。淨化器會移除 等主動內容。