Markdown 標題語法

標題是組織文檔結構最重要的元素。Markdown 支持兩種標題語法：ATX 風格和 Setext 風格。

ATX 風格標題

要創建標題，請在單詞或短語前面添加井號 (#)。井號的數量代表了標題的級別。

# 一級標題
## 二級標題  
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題

渲染效果

一級標題

二級標題

三級標題

四級標題

五級標題

六級標題

可選的關閉語法

你可以選擇性地「關閉」ATX 風格的標題，這純粹只是美觀用的：

# 一級標題 #
## 二級標題 ##
### 三級標題 ###

行尾的 # 數量不需要和開頭一樣，行首的井字符數量決定標題的階數。

Setext 風格標題

還可以在文本下方添加任意數量的 = 號來標識一級標題，或者 - 號來標識二級標題。

一級標題
========

二級標題
--------

渲染效果

一級標題

二級標題

標題最佳實踐

兼容性考慮

當井號（#）和標題文本之間沒有空格時，各 Markdown 應用程序的處理方式是不一樣的。為了兼容考慮，請在井號和標題文本之間添加一個空格。

✅ 推薦做法	❌ 不推薦
# 這是標題	#這是標題

空行的使用

為了兼容性，請在標題前後都添加空行。

這是一段文本。

# 這是標題

這是另一段文本。

標題層級

• 每個文檔建議只使用一個一級標題
• 保持標題層級的邏輯性，不要跳級
• 標題應該反映文檔的結構層次

標題文本規范

• 標題文本簡潔明確
• 避免使用標點符號（特別是句號）
• 使用動名詞或名詞短語
• 保持同級標題格式一致

HTML 輸出

Markdown 標題會被轉換為相應的 HTML 標題標簽：

# 標題       →  <h1>標題</h1>
## 標題      →  <h2>標題</h2>
### 標題     →  <h3>標題</h3>
#### 標題    →  <h4>標題</h4>
##### 標題   →  <h5>標題</h5>
###### 標題  →  <h6>標題</h6>

標題 ID（擴展功能）

許多 Markdown 處理器會自動為標題生成 ID，用於創建錨點鏈接：

<h1 id="markdown-標題語法">Markdown 標題語法</h1>

這樣你就可以鏈接到特定的標題：

[鏈接到標題](#markdown-標題語法)

實際應用示例

以下是一個展示良好標題結構的文檔示例：

# 產品使用手冊

## 快速開始

### 安裝步驟

#### 系統要求

#### 下載和安裝

### 基本配置

## 高級功能

### 自定義設置

### 插件管理

## 故障排除

### 常見問題

### 聯系支持

這種層次分明的標題結構使文檔易於閱讀和導航。

相關語法

• 段落和換行
• 列表
• 鏈接