الشطب
الشطب هو قاعدة موسعة في Markdown لتمثيل نص محذوف أو لم يعد سارياً. يفيد في مراجعات الوثائق، قوائم المهام، تغييرات الأسعار وغيرها.
القواعد الأساسية
الصياغة القياسية
عادة نستخدم موجتين ~~ لإحاطة النص المراد شطبه:
这是一段包含~~删除线文本~~的示例。العرض:
这是一段包含删除线文本的示例。
الكلمات والجُمل
يمكن تطبيق الشطب على كلمة أو جملة كاملة:
~~这整个句子都被划上了删除线。~~
我们将在下周~~周一~~周二开会。العرض:
这整个句子都被划上了删除线。
我们将在下周周一周二开会。
استخدامات متقدمة
مع تنسيقات أخرى
يمكن دمج الشطب مع صيغ Markdown الأخرى:
~~**粗体删除线**~~
~~*斜体删除线*~~
~~***粗体斜体删除线***~~
~~`代码删除线`~~
~~[链接删除线](https://www.markdownlang.com)~~العرض:
粗体删除线
斜体删除线
粗体斜体删除线
代码删除线
الفقرات والعناصر الكتلية
في بعض التطبيقات يمكن تطبيق الشطب على فقرات/عناصر كتلية كاملة:
~~
这是一个完整的被删除的段落。
它可以包含多行内容。
~~ملاحظة: ليس كل المعالجات تدعم الشطب متعدد الأسطر؛ استخدم الشطب على كل سطر عند الحاجة.
التوافق والفروقات بين المنصات
دعم المنصات المختلفة
| منصة/أداة | دعم الشطب | الصياغة |
|---|---|---|
| GitHub Markdown | ✅ | ~~删除线~~ |
| GitLab Markdown | ✅ | ~~删除线~~ |
| Stack Overflow | ✅ | ~~删除线~~ |
| Discord | ✅ | ~~删除线~~ |
| ✅ | ~~删除线~~ | |
| CommonMark | ✅ | ~~删除线~~ |
| VitePress | ✅ | ~~删除线~~ |
| Pandoc | ✅ | ~~删除线~~ |
ناتج HTML
تحوّل معظم المعالجات الشطب إلى وسم HTML <del> أو <s>:
<!-- 使用 <del> 标签 -->
<p>这是一段包含<del>删除线文本</del>的示例。</p>
<!-- 或使用 <s> 标签 -->
<p>这是一段包含<s>删除线文本</s>的示例。</p>صياغات بديلة
بعض المنصات أو النسخ القديمة قد تدعم صيغاً مختلفة:
<!-- 单波浪线(某些平台) -->
~删除线文本~
<!-- HTML 标签(所有符合规范的 Markdown 处理器) -->
<del>删除线文本</del>
<s>删除线文本</s>سيناريوهات الاستخدام
مراجعات الوثائق
يُستخدم الشطب غالباً لإظهار المراجعات والتغييرات:
# 项目计划 v2.0
## 时间表
- 需求分析:~~3月1日-3月15日~~ 3月1日-3月20日(延期)
- 设计阶段:~~3月16日-4月5日~~ 3月21日-4月10日
- 开发阶段:4月11日-5月15日
- 测试阶段:5月16日-5月30日
- 发布日期:~~6月1日~~ 6月15日العرض:
项目计划 v2.0
时间表
- 需求分析:
3月1日-3月15日3月1日-3月20日(延期) - 设计阶段:
3月16日-4月5日3月21日-4月10日 - 开发阶段:4月11日-5月15日
- 测试阶段:5月16日-5月30日
- 发布日期:
6月1日6月15日
قوائم المهام
يجعل الشطب مع خانات الاختيار قوائم المهام أوضح:
## 本周任务
- [x] ~~完成项目提案~~
- [x] ~~与客户会面讨论需求~~
- [ ] 创建设计原型
- [ ] 编写技术规格文档
- [ ] 准备预算估算العرض:
本周任务
- [x]
完成项目提案 - [x]
与客户会面讨论需求 - [ ] 创建设计原型
- [ ] 编写技术规格文档
- [ ] 准备预算估算
الأسعار والعروض
الشطب مفيد جداً في التجارة الإلكترونية والعروض:
## 特价商品
- 高性能笔记本电脑:~~¥8,999~~ ¥7,499
- 无线耳机:~~¥1,299~~ ¥999
- 智能手表:~~¥2,499~~ ¥1,999
*促销截止日期:2023年12月31日*العرض:
特价商品
- 高性能笔记本电脑:
¥8,999¥7,499 - 无线耳机:
¥1,299¥999 - 智能手表:
¥2,499¥1,999
促销截止日期:2023年12月31日
الدعابة والتأكيد
أحياناً يُستخدم للدعابة أو للتأكيد:
今天的会议~~非常无聊~~非常有成效。
我~~讨厌~~喜欢编写文档。
这个项目~~可能会失败~~必将成功!渲染效果:
今天的会议非常无聊非常有成效。
我讨厌喜欢编写文档。
这个项目可能会失败必将成功!
أفضل الممارسات
نصائح الاستخدام
✅ 推荐做法:
1. **清晰表达修改**:
- 删除旧内容,添加新内容
- 例如: ~~错误版本~~ 正确版本
2. **简洁使用**:
- 避免过多删除线内容影响可读性
- 考虑是否真的需要保留旧内容
3. **与其他标记结合**:
- 在任务列表中结合复选框使用
- 与其他格式化结合增强表现力
❌ 避免做法:
1. 删除线内使用过多复杂格式
2. 大段文本全部使用删除线(影响可读性)
3. 在重要文档中过度使用幽默性删除线
4. 对整篇文档或多个段落应用删除线اعتبارات الإتاحة
قد يربك الشطب مستخدمي قارئات الشاشة؛ راعِ ما يلي:
- 为删除线内容添加上下文说明
- 考虑使用其他方式(如括号、注释)来表示废弃内容
- 如果内容真的不再相关,考虑完全删除而不是使用删除线
<!-- أسلوب أفضل للوصولية -->
项目截止日期:3月15日(已更新:原计划3月1日)
<!-- 而不是 -->
项目截止日期:~~3月1日~~ 3月15日حلول للمشكلات الشائعة
الشطب لا يظهر
إن لم يظهر الشطب بشكل صحيح:
- 确认使用的是两个波浪线
~~,而不是一个~ - 检查波浪线和文本之间是否有空格(不应有空格)
- 验证您的 Markdown 处理器是否支持删除线语法
- 尝试使用 HTML
<del>标签作为替代
مشاكل الصيغ المعقّدة
قد تظهر مشكلات عند دمجه مع صيغ أخرى:
<!-- صياغة قد تكون إشكالية -->
~~**[复杂格式](https://www.markdownlang.com)**~~
<!-- صياغة أكثر أماناً -->
<del>**[复杂格式](https://www.markdownlang.com)**</del>شطب متعدد الفقرات
للشطْب عبر فقرات متعددة، من الأفضل استخدام HTML:
<del>
这是第一个被删除的段落。
这是第二个被删除的段落。
</del>قواعد ذات صلة
- قوائم المهام - إنشاء قوائم مهام تفاعلية
- التأكيد - قواعد التأكيد (عريض/مائل)
- HTML - استخدام HTML داخل Markdown
خلاصة
الشطب قاعدة بسيطة لكنها قوية لعرض التعديلات والمهام المنجزة أو المعلومات المتقادمة. بالاستخدام الرشيد يصبح المستند أوضح وأسهل في تتبع تطور المحتوى.