4.4 KiB
+++ 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$ هي مكتبة سريعة وسهلة الاستخدام تمكن من عرض الرموز الرياضية باستخدام صيغة 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!("مرحباً يا عالم") -> ();
}
من اليمين إلى اليسار
{% force_text_direction(direction="rtl") %}
نص قل_مرحباً(نص الاسم) {
أرجع تنسيق("مرحباً {الاسم}")؛
}
{% end %}
سطر برمجي
في Rust، تعلن عن متغير متغير باستخدام let mut x = 5، بينما في Python، تستخدم ببساطة x = 5. وبالمثل، لطباعة قيمة في Rust، تستخدم println!("القيمة: {}", x)، ولكن في Python، الأمر بسيط مثل print(f"القيمة: {x}")
وفي لغة البرمجة العربية هو مهنة = "صائد فئران"
اقتباس
وابِطُكَ قابِضِ الأَرواحِ يَرمي ... بِسَهمِ المَوتِ مِن تَحتِ الثِيابِ
شَرابُكَ في السَرابِ إِذا عَطِشنا ... وَخُبزُكَ عِندَ مُنقَطِعِ التُرابِ
— أبو الشمقمق، العصر العباسي
-
وهذا مثال على الهامش! ↩︎