← 返回教學列表
Markdown 語法指南：完整參考與範例
· 標籤: markdown-syntax, markdown-guide, markdown-formatting, github-flavored-markdown, markdown-reference
Markdown 語法指南
Markdown 是一種輕量標記語言，可將純文字轉換為格式化的 HTML。由 John Gruber 於 2004 年創建，現已成為文件、README 檔案和技術內容在網路上的標準寫作格式。
標題
使用 # 符號。一個 # 表示最高層級，最多六個表示最深層級：
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
層級應逐級遞增 —— 從 ## 跳到 #### 可能會混淆螢幕閱讀器。
文字格式
**Bold text** or __Bold text__
*Italic text* or _Italic text_
**_Bold and italic_**
~~Strikethrough text~~
連結
[Link text](https://example.com)
[Link with title](https://example.com "Title")
[Reference-style][ref-id]
[ref-id]: https://example.com
<contact@example.com>
圖片
[](https://example.com)
替代文字對無障礙性和 SEO 至關重要 —— 當圖片載入失敗時會顯示替代文字。
清單
無序清單使用 -、* 或 +。有序清單使用數字：
- Item one 1. First item
- Item two 2. Second item
- Nested item 1. Nested item
程式碼
行內程式碼使用單個反引號：`printf()`。
程式碼區塊使用三個反引號，可選擇加上語言識別符：
```python
def greet(name):
return f"Hello, {name}!"
支援的語言：`javascript`、`python`、`html`、`css`、`json`、`bash`、`sql`、`yaml`。
## 引用區塊
```markdown
> This is a blockquote.
> > Nested blockquotes are supported.
常用於提示、註解和引用外部來源。
水平分隔線
一行中包含三個或更多的破折號、星號或底線：
---
***
___
表格
使用管線和破折號定義欄位。冒號控制對齊方式：
| Left | Center | Right |
| :--- | :----: | ----: |
| A1 | B1 | C1 |
GitHub Flavored Markdown 擴展
GitHub Flavored Markdown (GFM) 新增了實用功能：
- [x] Completed task # Task lists
- [ ] Incomplete task
:smile: :rocket: :warning: # Emoji shortcodes
~~Strikethrough text~~ # Strikethrough
GFM 也會自動將 URL 轉為連結 —— www.example.com 無需使用 < > 包裹即可點擊。
跳脫特殊字元
在 Markdown 字元前加上 \ 即可顯示字面字元：
\*This is not italic\*
\# This is not a heading
需要跳脫的字元：\ ` * _ { } [ ] ( ) # + - . ! | ~。
Markdown 線上預覽
使用 Markdown 預覽工具即可即時撰寫和預覽 Markdown。即時預覽會隨著您輸入而更新，精確顯示標題、連結、圖片、程式碼區塊和表格的渲染效果。