دليل صيغة Markdown
صيغة أساسية لتنسيق مستنداتك
نظرة عامة
Markdown لغة ترميز خفيفة يمكنك استخدامها لإضافة عناصر تنسيق إلى مستندات النص العادي. أنشأها John Gruber عام 2004، Markdown الآن من أكثر لغات الترميز شيوعاً في العالم.
استخدام Markdown يختلف عن استخدام محرر WYSIWYG. في تطبيق مثل Microsoft Word تضغط أزراراً لتنسيق الكلمات والعبارات، والتغييرات تظهر فوراً. Markdown ليس كذلك. عند إنشاء ملف بصيغة Markdown، تضيف صيغة Markdown إلى النص للإشارة إلى الكلمات والعبارات التي يجب أن تظهر بشكل مختلف.
العناوين
لإنشاء عنوان، أضف علامات رقم (#) أمام كلمة أو عبارة. عدد العلامات يجب أن يتوافق مع مستوى العنوان. مثلاً لعنوان مستوى ثلاثة، استخدم ثلاث علامات (### عنواني).
Heading level 1
Heading level 2
Heading level 3
Heading level 4
Heading level 5
Heading level 6
الفقرات
لإنشاء فقرات، استخدم سطراً فارغاً لفصل سطر أو أكثر من النص.
It lets me write easily.
<p>It lets me write easily.</p>
I really like using Markdown.
It lets me write easily.
فواصل الأسطر
لإنشاء فاصل سطر أو سطر جديد، اختم السطر بمسافتين أو أكثر ثم اضغط Enter.
And this is the second line.
And this is the second line.</p>
This is the first line.
And this is the second line.
التأكيد
يمكنك إضافة تأكيد بجعل النص غامقاً أو مائلاً.
غامق
للنص الغامق، أضف نجمتين (**) أو شرطة سفلية (__) قبل وبعد كلمة أو عبارة.
I just love bold text.
I just love bold text.
مائل
للنص المائل، أضف نجمة واحدة (*) أو شرطة سفلية (_) قبل وبعد كلمة أو عبارة.
The cat meows.
The cat meows.
غامق ومائل
لتأكيد النص بغامق ومائل معاً، أضف ثلاث نجمات (***) أو شرطات سفلية (___) قبل وبعد كلمة أو عبارة.
This text is really important.
This text is really important.
اقتباسات الكتلة
لإنشاء اقتباس كتلة، أضف > أمام فقرة.
Dorothy followed her through many of the beautiful rooms in her castle.
اقتباسات كتلة متداخلة
يمكن تداخل اقتباسات الكتلة. أضف >> أمام الفقرة التي تريد تداخلها.
>
>> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
Dorothy followed her through many of the beautiful rooms in her castle.
The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
القوائم
يمكنك تنظيم العناصر في قوائم مرقمة وغير مرقمة.
القوائم المرقمة
للقائمة المرقمة، أضف عناصر سطور بأرقام متبوعة بنقاط. الأرقام لا يجب أن تكون بالترتيب العددي، لكن القائمة يجب أن تبدأ بواحد.
2. Second item
3. Third item
4. Fourth item
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>Fourth item</li>
</ol>
- First item
- Second item
- Third item
- Fourth item
القوائم غير المرقمة
للقائمة غير المرقمة، أضف شرطات (-)، نجمات (*)، أو علامات زائد (+) أمام عناصر السطور.
- Second item
- Third item
- Fourth item
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>Fourth item</li>
</ul>
- First item
- Second item
- Third item
- Fourth item
كود
لتعيين كلمة أو عبارة ككود، ضعها بين backticks (`).
At the command prompt, type nano.
كتل الكود
لكتلة كود، ضع مسافة بادئة لكل سطر في الكتلة بأربع مسافات على الأقل أو تاب واحد، أو استخدم ثلاثة backticks (```) قبل وبعد كتلة الكود.
{
"firstName": "John",
"lastName": "Smith",
"age": 25
}
```
{
"firstName": "John",
"lastName": "Smith",
"age": 25
}الخطوط الأفقية
لخط أفقي، استخدم ثلاث نجمات (***)، شرطات (---)، أو شرطات سفلية (___) في سطر لوحدها.
الروابط
لإنشاء رابط، ضع نص الرابط بين قوسين معقوفين (مثلاً [Duck Duck Go]) ثم أتبعه فوراً بالـ URL بين قوسين (مثلاً (https://duckduckgo.com)).
My favorite search engine is Duck Duck Go.
إضافة العناوين
يمكنك اختيارياً إضافة عنوان لرابط. سيظهر كتلميح عند تمرير المؤشر فوق الرابط. لإضافة عنوان، ضعه بين علامات اقتباس بعد الـ URL.
My favorite search engine is Duck Duck Go.
الصور
لإضافة صورة، أضف علامة تعجب (!)، متبوعة بنص بديل بين قوسين معقوفين ومسار أو URL الصورة بين قوسين. يمكنك اختيارياً إضافة عنوان بين علامات اقتباس بعد المسار أو الـ URL.
تهريب الأحرف
لعرض حرف حرفي يُستخدم خلاف ذلك لتنسيق النص في مستند Markdown، أضف backslash (\) أمام الحرف.
* Without the backslash, this would be a bullet in an unordered list.
الأحرف التي يمكن تهريبها
يمكنك استخدام backslash لتهريب الأحرف التالية:
| \ | backslash |
| ` | backtick |
| * | asterisk |
| _ | underscore |
| { } | curly braces |
| [ ] | brackets |
| ( ) | parentheses |
| # | pound sign |
| + | plus sign |
| - | minus sign (hyphen) |
| . | dot |
| ! | exclamation mark |
| | | pipe |
الجداول
لجدول، استخدم ثلاث شرطات (---) أو أكثر لرأس كل عمود، وأنابيب (|) لفصل الأعمدة. يمكنك اختيارياً إضافة أنابيب في طرفي الجدول.
| --------- | ----------- |
| Header | Title |
| Paragraph | Text |
| Syntax | Description |
|---|---|
| Header | Title |
| Paragraph | Text |
المحاذاة
يمكنك محاذاة النص في الأعمدة لليسار أو اليمين أو الوسط بإضافة نقطتين (:) لليسار أو اليمين أو جانبي الشرطات في صف الرأس.
| :--- | :---: | ---: |
| This | This | This |
| column | column | column |
| will | will | will |
| align | align | align |
| left | center | right |
| محاذاة لليسار | توسيط | محاذاة لليمين |
|---|---|---|
| This | This | This |
| column | column | column |
| will | will | will |
| align | align | align |
| left | center | right |