Skip to content

強調語法

強調語法用於突出顯示文本,是 Markdown 中最常用的格式化功能之一。通過不同的強調方式,可以讓重要內容更加醒目。

基本強調語法

斜體(Italic)

使用單個星號 * 或下劃線 _ 包圍文本:

markdown
*斜體文本*
_斜體文本_

渲染效果斜體文本斜體文本

粗體(Bold)

使用雙星號 ** 或雙下劃線 __ 包圍文本:

markdown
**粗體文本**
__粗體文本__

渲染效果粗體文本粗體文本

粗斜體(Bold and Italic)

使用三個星號 *** 或三個下劃線 ___,或者混合使用:

markdown
***粗斜體文本***
___粗斜體文本___
**_粗斜體文本_**
*__粗斜體文本__*

渲染效果粗斜體文本粗斜體文本粗斜體文本粗斜體文本

語法選擇建議

星號 vs 下劃線

符號優點缺點推薦場景
*更常見,兼容性好在某些編輯器中可能與列表混淆一般推薦
_在單詞內部更清晰較少使用,可能不熟悉特殊情況

推薦用法

markdown
✅ 推薦:保持一致性
這裡有 **粗體***斜體* 文本。

❌ 不推薦:混合使用
這裡有 **粗體**_斜體_ 文本。

在單詞內部使用強調

星號的限制

星號在單詞內部可能不會被識別:

markdown
love*is*beautiful  ← 可能不會渲染為斜體

下劃線的優勢

下劃線在單詞內部更可靠:

markdown
love_is_beautiful  ← 更容易被正確渲染

建議:如果需要在單詞內部使用強調,優先考慮下劃線。

嵌套強調

基本嵌套

可以在粗體內嵌套斜體,或在斜體內嵌套粗體:

markdown
**這是粗體,包含 *斜體* 文本**
*這是斜體,包含 **粗體** 文本*

渲染效果這是粗體,包含 斜體 文本這是斜體,包含 粗體 文本

復雜嵌套

markdown
***這是粗斜體,包含 normal 文本***
**粗體段落,包含 *斜體子句* 和普通文本**
*斜體段落,包含 **粗體關鍵詞** 和普通文本*

渲染效果這是粗斜體,包含 normal 文本粗體段落,包含 斜體子句 和普通文本斜體段落,包含 粗體關鍵詞 和普通文本

常見錯誤和解決方案

1. 符號不匹配

markdown
❌ 錯誤:
*這是未閉合的斜體
**這是不匹配的粗體*

✅ 正確:
*這是正確的斜體*
**這是正確的粗體**

2. 空格問題

markdown
❌ 錯誤:
* 這不是斜體 *
** 這不是粗體 **

✅ 正確:
*這是斜體*
**這是粗體**

3. 符號周圍的字符

markdown
❌ 可能有問題:
文本*斜體*文本  ← 可能不會渲染

✅ 更安全:
文本 *斜體* 文本
文本_斜體_文本

特殊情況處理

轉義強調符號

如果需要顯示星號或下劃線本身,使用反斜槓轉義:

markdown
\*這不是斜體\*
\**這不是粗體\**
\_這不是斜體\_

渲染效果: *這不是斜體* *這不是粗體* _這不是斜體_

在代碼中使用

在行內代碼中,強調符號會被按字面意思顯示:

markdown
`*這裡的星號不會被解釋為斜體*`
`**這裡的雙星號不會被解釋為粗體**`

渲染效果*這裡的星號不會被解釋為斜體***這裡的雙星號不會被解釋為粗體**

語義化使用

斜體的語義用途

  • 強調這很重要
  • 外文Hello World
  • 術語HTTP 協議
  • 引用:如 《三國演義》 所述
  • 變量:設置 x 的值為 10

粗體的語義用途

  • 重要性注意安全
  • 關鍵詞API 接口
  • 警告不要刪除重要文件
  • 小標題第一步:安裝軟件

粗斜體的用途

  • 極其重要絕對不要這樣做
  • 強烈建議強烈推薦閱讀文檔

最佳實踐

1. 適度使用

markdown
✅ 推薦:適度強調
這個功能**很重要**,請仔細閱讀相關文檔。

❌ 不推薦:過度強調
**這個功能*****很重要*****請仔細閱讀****相關文檔**

2. 保持一致性

markdown
✅ 推薦:統一使用星號
使用 **粗體***斜體* 來強調內容。

❌ 不推薦:混合符號
使用 **粗體**_斜體_ 來強調內容。

3. 語義化使用

markdown
✅ 推薦:有意義的強調
函數返回 **true** 表示成功,返回 **false** 表示失敗。

❌ 不推薦:裝飾性強調
函數**返回** true **表示**成功,**返回** false **表示**失敗。

HTML 輸出

Markdown 強調語法轉換為 HTML:

markdown
*斜體*     → <em>斜體</em>
**粗體**   → <strong>粗體</strong>
***粗斜體*** → <strong><em>粗斜體</em></strong>

擴展語法

某些 Markdown 處理器支持額外的強調方式:

刪除線

markdown
~~刪除的文本~~

渲染效果刪除的文本

下劃線

markdown
<u>下劃線文本</u>

渲染效果下劃線文本

高亮

markdown
==高亮文本==  (某些處理器支持)
<mark>高亮文本</mark>  (HTML 標簽)

實用示例

技術文檔

markdown
**API 端點**`/api/users`

**方法***GET*

**參數**
- *id****必需***):用戶 ID
- *format*(可選):返回格式

**返回**:用戶信息或 **錯誤消息**

用戶指南

markdown
## 安裝步驟

**第一步**:下載安裝包

訪問官網下載頁面,選擇適合你操作系統的版本。*請確保下載最新版本*

**第二步**:運行安裝程序

雙擊下載的文件,按照向導完成安裝。***重要***:安裝過程中請關閉殺毒軟件。

**第三步**:驗證安裝

打開命令行,輸入 `app --version` 檢查是否安裝成功。

相關語法

練習

嘗試創建包含以下內容的文檔:

  1. 一個產品介紹,使用粗體突出關鍵特性
  2. 一段技術說明,使用斜體標注術語
  3. 一個警告信息,使用粗斜體強調重要性
  4. 混合使用各種強調方式的復合句子

由 Markdownlang.com 整理創建