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

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

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

- تم التحديث في 1 سبتمبر 2023
- •الإطلاع على التغييرات

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

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

يدعم تابي الكتابة من اليمين إلى اليسار (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

يمكنك أيضاً تفعيله بشكل عام عن طريق تعيين `katex = true` في قسم `[extra]` في ملف `config.toml` الخاص بك.

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

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

## جدول

هذا مثال على جدول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. وهذا مثال على الهامش! ↩

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