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 整理创建