# ~/تابي • أمثلة على ماركداون
تعرض هذه التدوينة بعض الأمثلة على تنسيق ماركداون، بما في ذلك الجداول، والشِفرات البرمجية والوسوم، والاقتباسات، والهوامش.

الإنتقال إلى المحتوى

# أمثلة على ماركداون

- 31 يناير 2023
- •الوقت المتوقع للقراءة: دقيقتان
- •الوسوم:
- ماركداون,
- توضيحي

- تم التحديث في 1 يناير 2026
- • الإطلاع على التغييرات

تعرض هذه التدوينة بعض الأمثلة على تنسيق ماركداون، بما في ذلك الجداول، والشِفرات البرمجية والوسوم، والاقتباسات، والهوامش.

ملاحظة عن الاتجاه

يدعم تابي الكتابة من اليمين إلى اليسار (RTL) بشكل كامل، مما يجعله مثالياً للغة العربية.

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

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

تأتي كلمة ماركداون من الإنجليزية Markdown، وهي لغة ترميز بسيطة صممها جون غروبر وآرون سوارتز في عام 2004.

$\KaTeX$ هي مكتبة سريعة وسهلة الاستخدام تمكن من عرض الرموز الرياضية باستخدام صيغة 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]`:

    title = "تجربة KaTeX"
    date = 2002-11-30

    [extra]
    katex = true

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

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

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

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

الصيغ الكيميائية مدعومة عبر امتداد 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

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

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

### من اليمين إلى اليسار

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

## سطر برمجي

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

## اقتباس

> وابِطُكَ قابِضِ الأَرواحِ يَرمي … بِسَهمِ المَوتِ مِن تَحتِ الثِيابِ

> شَرابُكَ في السَرابِ إِذا عَطِشنا … وَخُبزُكَ عِندَ مُنقَطِعِ التُرابِ

> — أبو الشمقمق، العصر العباسي

1. وهذا مثال على الهامش! ↩

تم النسخ! نسخ الشِفرة إلى الحافظة