التمييز

التمييز هو قاعدة موسعة في Markdown لإبراز النص المهم داخل الوثائق، ما يساعد القارئ على رصد المعلومات المحورية بسرعة.

القواعد الأساسية

تمييز بالنص

في معظم التطبيقات الداعمة، نستخدم علامتي مساواة == لإحاطة النص المراد تمييزه:

这是一段包含==高亮文本==的示例。

العرض:

这是一段包含==高亮文本==的示例。

تمييز كلمات وعبارات

يمكن تطبيق التمييز على كلمة مفردة أو عبارة:

在编程中，==变量== 是存储数据的命名空间。

请确保阅读文档中的==重要提示和警告==。

العرض:

在编程中，==变量== 是存储数据的命名空间。

请确保阅读文档中的==重要提示和警告==。

استخدامات متقدمة

مع تنسيقات أخرى

يمكن دمج التمييز مع صيغ Markdown الأخرى:

==**粗体高亮**==

==*斜体高亮*==

==***粗体斜体高亮***==

==`代码高亮`==

==[链接高亮](https://www.markdownlang.com)==

العرض:

==粗体高亮==

==斜体高亮==

==粗体斜体高亮==

==代码高亮==

==链接高亮==

تمييز على مستوى الكتلة

تسمح بعض التطبيقات بتمييز كتلي لمحتوى كامل عبر حاويات مخصّصة:

::: highlight
这是一个高亮的段落块。

它可以包含多行内容，甚至可以包含列表:
- 项目 1
- 项目 2
- 项目 3
:::

ملاحظة: دعم التمييز الكتلي يختلف حسب المعالج؛ المثال أعلاه يعمل في منصات تدعم الحاويات المخصصة مثل VitePress.

التوافق وفروقات التنفيذ

دعم المنصات المختلفة

منصة/أداة	دعم التمييز	الصياغة
GitHub Markdown	❌	不支持
GitLab Markdown	✅	==高亮==
Hugo	✅	使用mark标签或 ==高亮==
VitePress	✅	==高亮==
Pandoc	✅	==高亮== 或 [高亮]{.mark}
Jekyll	✅	取决于所用主题和插件
CommonMark	❌	不支持

ناتج HTML

تحوّل أغلب المعالجات الداعمة التمييز إلى وسم <mark> أو صنف CSS خاص:

<!-- 使用 mark 标签 -->
<p>这是一段包含<mark>高亮文本</mark>的示例。</p>

<!-- 使用自定义类 -->
<p>这是一段包含<span class="highlighted">高亮文本</span>的示例。</p>

صيغ بديلة

على المنصات غير الداعمة يمكن استخدام HTML كبديل:

这是一段包含<mark>高亮文本</mark>的示例。

<!-- 或使用自定义样式 -->
这是一段包含<span style="background-color: yellow;">高亮文本</span>的示例。

سيناريوهات الاستخدام

إبراز نقاط مهمة في الوثائق

يفيد التمييز لتأكيد المحتوى المهم:

# دليل التثبيت

يرجى ==أخذ نسخة احتياطية كاملة لبياناتك== قبل التثبيت. قد يهيّئ المُثبّت القسم الهدف.

خطوات التثبيت:
1. تنزيل المُثبّت
2. تشغيل معالج التثبيت
3. ==اختيار خيار "تثبيت مخصص"==
4. اتبع الإرشادات حتى الإنهاء

نتيجة العرض:

安装指南

请在安装前==完整备份您的数据==。系统安装过程将会格式化目标分区。

安装步骤：

1. 下载安装程序
2. 运行安装向导
3. ==选择"自定义安装"选项==
4. 按照屏幕提示完成安装

مواد تعليمية

التمييز مفيد جداً في المواد التعليمية:

## متغيّرات Python

في Python تُسنَد القيم إلى المتغير باستخدام `=`:

```python
x = 10  # 将值 10 赋给变量 x

==Python لغة ديناميكية النوع؛ يتحدد نوع المتغيّر عند الإسناد.==

أنواع شائعة:

• عدد صحيح (int)
• عدد عشري (float)
• سلسلة (str)
• منطقي (bool)

### مقارنة النصوص والمراجعات

يمكن استخدام التمييز لإبراز التغييرات/الفروقات:

```markdown
## مقارنة نسخ الوثيقة

### النسخة الأصلية
سيُجرى صيانة الخادم كل أحد 02:00.

### النسخة المحدثة
سيُجرى صيانة الخادم كل أحد 02:00. ==المدة المتوقعة ساعتان.==

نتيجة العرض:

文档版本比较

原始版本

服务器将在每周日凌晨 2:00 进行维护。

更新版本

服务器将在每周日凌晨 2:00 进行维护。==维护时长预计为 2 小时。==

اقتباسات وتعليقات

يمكن استخدامه لتأكيد مقاطع ضمن اقتباس:

> "هذا نص مقتبس، ==وهذا الجزء مهم جداً== ويحتاج انتباهاً."
> 
> — 某知名作者

نتيجة العرض:

"这是一段引述文本，==其中这部分内容特别重要==，需要读者特别注意。"

— 某知名作者

تخصيص الأنماط

في بيئات تدعم CSS مخصّصاً يمكن تعديل نمط التمييز:

/* نمط تمييز مخصّص */
mark, .highlighted {
  background-color: #ffeb3b;  /* خلفية صفراء */
  color: #000;                /* نص أسود */
  padding: 0 3px;            /* حشوة */
  border-radius: 3px;        /* زوايا مستديرة */
}

/* أنواع تمييز مختلفة */
.highlight-warning {
  background-color: #ffcdd2;  /* تحذير */
}

.highlight-success {
  background-color: #c8e6c9;  /* نجاح */
}

استخدام أنماط مخصصة:

هذا <mark class="highlight-warning">تحذير</mark>، وهذا <mark class="highlight-success">نجاح</mark>.

أفضل الممارسات

نصائح الاستخدام

✅ ممارسات موصى بها:

1. **استخدم التمييز باعتدال**:
   - 仅高亮真正重要的内容
   - 过多高亮会削弱突出效果
   
2. **حافظ على الاتساق**:
   - 在整个文档中使用一致的高亮风格
   - 为不同类型的重点内容使用不同的高亮样式
   
3. **اربط بالسياق**:
   - 确保高亮内容与周围文本有逻辑联系
   - 可以添加简短说明解释为何某内容被高亮

❌ تجنّب:

1. 高亮过长的段落或整个章节
2. 在一个页面上过度使用高亮
3. 为不重要的内容添加高亮
4. 使用过多不同颜色或样式的高亮

اعتبارات الإتاحة

قد يسبب التمييز صعوبة لدى بعض المستخدمين. راعِ:

1. 确保高亮色彩与背景有足够对比度
2. 不要仅依赖颜色来传达信息
3. 考虑为高亮内容添加额外的标记（如图标或标题）
4. 测试文档在不同阅读模式下的可读性（如深色模式）

حلول للمشكلات الشائعة

التمييز لا يظهر

إن لم يظهر التمييز بشكل صحيح:

1. 检查平台是否支持 == 语法的高亮
2. 尝试使用 HTML <mark> 标签作为替代
3. 确保 == 与高亮文本之间没有空格
4. 检查文档是否引用了正确的 CSS 样式

تعارض مع تنسيقات أخرى

قد يتعارض التمييز أحياناً مع صيغ أخرى:

<!-- صياغة قد تكون إشكالية -->
==**复杂[格式](https://www.markdownlang.com)内容**==

<!-- صياغة أكثر أماناً -->
<mark>**复杂[格式](https://www.markdownlang.com)内容**</mark>

مشكلات التمييز الكتلي

لتمييز كتلة كاملة يُنصح باستخدام HTML أو حاوية مخصّصة:

<!-- 使用 HTML -->
<div class="highlighted-block">

# 重要章节

这是一个需要整体高亮的内容块。

</div>

<!-- 或使用自定义容器（在支持的平台上） -->
::: highlight
# 重要章节

这是一个需要整体高亮的内容块。
:::

قواعد ذات صلة

• التأكيد - قواعد التأكيد (عريض/مائل)
• الاقتباس - تنسيق اقتباسات الكتل
• HTML - استخدام HTML داخل Markdown

أدوات وإضافات

• markdown-it-mark: 为 markdown-it 添加高亮支持
• remark-highlight.js: 为代码添加语法高亮
• gatsby-remark-highlight-code: Gatsby 中的代码高亮插件

总结

高亮是一种有效的扩展语法，可以增强文档的可读性和关键信息的可见度。虽然不是所有 Markdown 处理器都原生支持高亮语法，但通过 HTML 标签和自定义 CSS，我们可以在几乎任何环境中实现相似的效果。合理使用高亮可以帮助读者快速定位文档中的重要内容，提升整体阅读体验。