删除线 #

概述 #

删除线用于表示被删除或不再有效的内容,是 GitHub Flavored Markdown 的扩展语法。

基本语法 #

使用双波浪线包裹文本:

markdown
~~删除的内容~~

渲染效果:删除的内容

用途 #

表示已删除内容 #

markdown
原价 ~~99元~~ 现价 49元

渲染效果:原价 99元 现价 49元

标记过时信息 #

markdown
~~使用 var 声明变量~~(已废弃,请使用 let 或 const)

版本变更记录 #

markdown
## 更新日志

- ~~旧功能A~~ - 已移除
- 新功能B - 新增

任务完成标记 #

markdown
- ~~完成需求分析~~
- ~~完成设计稿~~
- 进行开发中

与其他语法组合 #

删除线 + 强调 #

markdown
~~**重要内容已删除**~~
~~*斜体删除内容*~~

删除线 + 链接 #

markdown
~~[旧链接](https://old.example.com)~~

删除线 + 代码 #

markdown
~~`deprecatedFunction()`~~ 已废弃

实际应用 #

价格展示 #

markdown
## 商品信息

商品名称:高级版会员
原价:~~¥199/月~~
现价:**¥99/月**

API 变更说明 #

markdown
## API 变更

- ~~`getUser()`~~ - v2.0 已移除
- ~~`updateUser()`~~ - v2.0 已移除
- `fetchUser()` - v2.0 新增
- `modifyUser()` - v2.0 新增

功能状态 #

markdown
## 功能列表

| 功能 | 状态 |
|------|------|
| ~~旧版编辑器~~ | 已下线 |
| 新版编辑器 | 正常 |
| 协作功能 | 开发中 |

文档更新 #

markdown
## 配置说明

~~`oldConfig: true`~~(v1.x 配置,已废弃)

`newConfig: true`(v2.x 新配置)

常见问题 #

问题1:删除线不显示 #

检查:

  • 是否使用双波浪线 ~~
  • 波浪线是否闭合
markdown
正确:~~内容~~
错误:~内容~
错误:~~内容

问题2:与其他语法冲突 #

markdown
正确:~~**内容**~~
错误:**~~内容~~**(可能导致解析问题)

最佳实践 #

1. 说明删除原因 #

markdown
好的:
~~旧方法~~(已废弃,请使用新方法)

不好的:
~~旧方法~~

2. 提供替代方案 #

markdown
好的:
~~`var`~~ 请使用 `let` 或 `const`

不好的:
~~`var`~~

3. 配合更新日志使用 #

markdown
## v2.0.0

- ~~移除旧API~~
- 新增新API

下一步 #

继续学习 脚注

最后更新:2026-03-24