+++
title = "أمثلة على ماركداون"
date = 2023-01-31
updated = 2026-01-01
description = "تعرض هذه التدوينة بعض الأمثلة على تنسيق ماركداون، بما في ذلك الجداول، والشِفرات البرمجية والوسوم، والاقتباسات، والهوامش."

[taxonomies]
tags = ["ماركداون", "توضيحي"]

[extra]
katex = true
+++

{% admonition(type="note", title="ملاحظة عن الاتجاه", icon="info") %}
يدعم تابي الكتابة من اليمين إلى اليسار (RTL) بشكل كامل، مما يجعله مثالياً للغة العربية.

الشفرات البرمجية والمعادلات الرياضية تبقى من اليسار إلى اليمين كما هو متوقع.
{% end %}

## الرياضيات مع $\KaTeX$

{{ aside(text="تأتي كلمة *ماركداون* من الإنجليزية *Markdown*، وهي لغة ترميز بسيطة صممها جون غروبر وآرون سوارتز في عام 2004.") }}

[$\KaTeX$](https://katex.org/) هي مكتبة سريعة وسهلة الاستخدام تمكن من عرض الرموز الرياضية باستخدام صيغة LaTeX.

يمكنك استخدام $\KaTeX$ **ضمن السطر** عن طريق وضع التعبير بين `$` أو بين `\\(` و `\\)`.

على سبيل المثال، `$ \sin(x) = \sum_{n=0}^{\infty} \frac{(-1)^n}{(2n + 1)!} x^{2n + 1} $` سيظهر هكذا: $ \sin(x) = \sum_{n=0}^{\infty} \frac{(-1)^n}{(2n + 1)!} x^{2n + 1} $

لعرض التعبير **في سطر منفصل ومتوسط**، ضعه بين `$$` أو بين `\\[` و `\\]`.

على سبيل المثال، `\\[ r = \frac{\sum_{i=1}^{n}(x_i - \bar{x})(y_i - \bar{y})}{\sqrt{\sum_{i=1}^{n}(x_i - \bar{x})^2}\sqrt{\sum_{i=1}^{n}(y_i - \bar{y})^2}} \\]` سيظهر هكذا: \\[ r = \frac{\sum_{i=1}^{n}(x_i - \bar{x})(y_i - \bar{y})}{\sqrt{\sum_{i=1}^{n}(x_i - \bar{x})^2}\sqrt{\sum_{i=1}^{n}(y_i - \bar{y})^2}} \\]

فعّل $\KaTeX$ بإضافة `katex = true` في `[extra]`:

```toml,hl_lines=5-6
title = "تجربة KaTeX"
date = 2002-11-30

[extra]
katex = true
```

يعمل في: مقدمة الصفحة، `_index.md` للقسم، أو عالمياً في `config.toml`.

لتحسين الأداء والأمان، يتم استضافة ملفات جافا سكريبت و CSS والخطوط الخاصة بـ $\KaTeX$ محلياً.

**ملاحظة**: بعد تفعيل $\KaTeX$، إذا أردت استخدام \$ بدون عرض تعبير رياضي، استخدم شرطة مائلة للخلف قبلها: `\$`.

### الصيغ الكيميائية

الصيغ الكيميائية مدعومة عبر [امتداد mhchem](https://mhchem.github.io/MathJax-mhchem/)، الذي يُحمّل تلقائياً عند استخدام `\ce{}` أو `\pu{}`.

`\ce{}` للكيمياء: $\ce{H2O}$، $\ce{CO2 + H2O -> H2CO3}$

`\pu{}` للوحدات: $\pu{25 °C}$، $\pu{1.2 mol/L}$

## جدول

هذا مثال على جدول[^1]. تتغير ألوانه حسب سمة التدوينة.

| الرمز  | العنصر   | العدد الذري |
|--------|----------|--------------|
| H      | هيدروجين| 1            |
| C      | كربون    | 6            |
| Fe     | حديد     | 26           |
| Au     | ذهب      | 79           |

## الشِفرات البرمجية

```rust
fn main() {
    println!("مرحباً يا عالم") -> ();
}
```

### من اليمين إلى اليسار
{% force_text_direction(direction="rtl") %}

```
نص قل_مرحباً(نص الاسم) {
    أرجع تنسيق("مرحباً {الاسم}")؛
}
```

{% end %}

## سطر برمجي

في Rust، تعلن عن متغير متغير باستخدام `let mut x = 5`، بينما في Python، تستخدم ببساطة `x = 5`. وبالمثل، لطباعة قيمة في Rust، تستخدم `println!("القيمة: {}", x)`، ولكن في Python، الأمر بسيط مثل `print(f"القيمة: {x}")`
وفي لغة البرمجة العربية هو `مهنة = "صائد فئران"`

## اقتباس

> وابِطُكَ قابِضِ الأَرواحِ يَرمي   ...   بِسَهمِ المَوتِ مِن تَحتِ الثِيابِ
>
> شَرابُكَ في السَرابِ إِذا عَطِشنا   ...   وَخُبزُكَ عِندَ مُنقَطِعِ التُرابِ
>
> — أبو الشمقمق، العصر العباسي

[^1]: وهذا مثال على الهامش!
