دليل الغش الخاص بـ How-To Geek’s Markdown

Markdown هو بديل قوي لـ HTML لإنشاء محتوى مكتوب يمكن مشاركته بسهولة عبر الإنترنت أو حفظه في تطبيق ملاحظات أو تصديره إلى تنسيقات أخرى. إليك ورقة غش لمساعدتك على فهم كل ما يتعلق بالموضوع.

قواعد لغة ترميز Markdown الأساسية

توجد تطبيقات مختلفة لـ Markdown، بعضها يتوسع في بناء الجملة الأساسي مع دعم المزيد من الميزات (مثل التنسيقات الرياضية). وبغض النظر عن التطبيق الذي تستخدمه، فإن بناء الجملة الأساسي يظل كما هو.

فيما يلي قائمة بأوامر Markdown البسيطة والشائعة. يشار إلى هذه الصيغة الأساسية عادةً باسم العلامة التجارية المشتركة.

**Bold** 

__Bold__ 

*Italic* 

_Italic_ 

Heading 1
==========
Heading 2
 

(How-To Geek)(http: 

!(Alt-Text)(http: 

            - Item 1
            - Item 2
            - Item 3 

            1. Item 1
            2. Item 2
            3. Item 3 

1) Item 1
2) Item 2
3) Item 3 

`code` 

```
code
block
```
             

*** 

Advanced Markdown Syntax

On top of the basic syntax listed above, your Markdown editor may also support some more advanced functions, such as:

| Column 1 | Column 2 |
| 
| Item 1 | Item 2 |
| Item 3 | Item 4 | 

~~strikethrough~~ 

- ( ) Unchecked item
- (X) Checked item 

Example of a footnote(^1) within text.
(^1): Description of footnote text 

==highlighted text== 

$$ equation goes here $$ 

:emoji-name: 

E=MC^2^ 

O~2~ 

Term to define
: This is the definition of the term
: This is another definition
Another term
: Yet another definition 

إنشاء روابط في Markdown

يتم إنشاء الروابط في Markdown عن طريق وضع النص المؤقت بين قوسين مربعين، متبوعًا مباشرةً بالرابط الذي تريد مشاركته بين قوسين قياسيين بعده مباشرةً. تأكد من عدم وجود فجوة بينهما عند إنشاء الرابط، كما يلي:

(How-To Geek)(

إدراج الصور باستخدام Markdown

يمكن إدراج الصور باستخدام Markdown بين قوسين مربعين وقوسين قياسيين. يجب أن يوضع النص البديل الوصفي الذي تستخدمه بين قوسين مربعين، مع رابط للصورة يليه بين قوسين قياسيين، كما يلي:

!(alt-text)(

إذا كنت تواجه مشكلة في تشغيل هذه الميزة، فتأكد من أن الصورة موجودة في الموقع الذي تحدده. إذا كنت تقوم بسحب الصور إلى محرر Markdown، فسوف يشير الرابط إلى موقع الصورة على محرك الأقراص المحلي لديك وليس موقعها على خادم الويب.

كيفية إنشاء جدول في Markdown

تُعد الجداول أحد العناصر الأكثر إرباكًا في لغة ترميز Markdown، ولكنها تعمل بشكل جيد طالما أنك تتأكد من أن الأسطر والمسافات كلها في المكان الصحيح. يمكنك التمييز بين صف رأس الجدول باستخدام الشرطات، والتي تحتاج إلى ثلاثة منها فقط.

| Column 1 | Column 2 |
| 
| Item 1 | Item 2 |
 

يمكنك تجميل الجدول الخاص بك في عرض الكود إذا كنت تريد ذلك (وإضافة المزيد من المسافات والشرطات لتحسين قابليته للقراءة)، ولكن إذا كان كل ما يهمك هو النتيجة النهائية، فإن المثال أعلاه يعمل بشكل جيد.

ضع في اعتبارك أن العديد من محرري Markdown سيكون لديهم أدواتهم الخاصة لإنشاء الجداول، وتوسيع عدد الصفوف والأعمدة بسرعة، والتنسيق التلقائي لنسخ العناصر ولصقها داخل العمود أو خارجه. يمكن تنفيذ ذلك بسهولة إذا كان التطبيق الذي تختاره يدعمه.

كيفية استخدام كتل التعليمات البرمجية في Markdown

لإنشاء كتلة تعليمات برمجية في Markdown، لديك خياران. يمكنك إما وضع النص في علامة الترقيم `، المعروفة بالعامية باسم علامة الاقتباس العكسية أو المفتاح الذي يظهر أسفل "Esc" على معظم لوحات المفاتيح.

`code`

بالنسبة لكتلة من التعليمات البرمجية، استخدم ثلاث علامات ترقيم "" في بداية الكتلة، ثم ثلاث علامات ترقيم أخرى في نهايتها. يتيح لك هذا اقتباس أسطر متعددة من التعليمات البرمجية.

```
code block
``` 

إنشاء فواصل الأسطر (القواعد الأفقية) في Markdown

تعتبر فواصل الأسطر مفيدة للإشارة إلى نهاية قسم وبداية قسم آخر. يدعم CommonMark فواصل الأسطر من خلال استخدام ثلاث شرطات:

---

تتطلب بعض المحررات (مثل Ulysses) أربع شرطات لتفعيل كسر السطر.

كيفية شطب النص باستخدام Markdown

لا يتم دعم الشطب عادةً في Markdown، وبالتالي قد يختلف تنفيذه بين المحررين. إحدى الطرق الشائعة لاستخدام الشطب هي استخدام رمزين من علامات التلدة، على النحو التالي:

~~strikethrough text~~

تتضمن بعض المحررات علامة "حذف"، والتي تعمل على النحو التالي:

||delete this text||

استخدام Subscript وUpscript في Markdown

تسمح لك بعض برامج التحرير باستخدام الرمز السفلي على جانبي الإدخال الذي تريد تنسيقه، كما يلي:

O~2~

يستخدم البعض الآخر الأشكال المائلة لرفع النص، كما يلي:

E=MC^2^

إذا لم يقم محرر النصوص الخاص بك بذلك وكنت سعيدًا باستخدام HTML، فكلاهما و يمكن استخدام علامات HTML للنص السفلي والنص العلوي على التوالي.

تمييز النص في Markdown

وظيفة أخرى غير قياسية ولكن بعض المحررين يدعمونها، حيث قد تتمكن من تسليط الضوء على الأعمال باستخدام رمزين متساويين على جانبي الكلمة، كما يلي:

You can't always =highlight text== in Markdown

يستخدم بعض المحررين طريقتهم الخاصة في التمييز. يمكن لـ Ulysses استخدام صيغة "Mark":

Some editors use other syntax to ::highlight text:: with Markdown

إنشاء قوائم المهام في Markdown (مع مربعات الاختيار)

قوائم المهام مفيدة لتتبع التذكيرات، وهي تعمل مثل القوائم غير المرتبة إلا أنها تحتوي على خطوة إضافية واحدة. بالإضافة إلى الشرطة التي تحتاج إلى استخدامها لتحديد قائمة في بداية السطر، تحتاج أيضًا إلى إضافة مربع الاختيار في حالته المحددة أو غير المحددة، كما يلي:

- ( ) This item is unchecked- (X) This item is checked

اختيارك للمحرر مهم

إن Markdown متعدد الاستخدامات وقوي، ولكن التجربة يمكن أن تكون أفضل مع النوع المناسب من المحرر. تضع تطبيقات مثل Ulysses وiA Writer سعرًا لتجربة Markdown، ولكن من المؤكد أنها تستحق ذلك إذا كنت تقضي وقتًا طويلاً في الكتابة للويب.

لتدوين الملاحظات، هناك تطبيقات مثل دُبٌّ و حجر السج تتوفر خطط مجانية ممتازة مع مسارات ترقية بأسعار معقولة إذا كنت بحاجة إلى المزيد. بالطبع، هناك الكثير من المحررين المجانيين مثل ماكداون و مارك تيكست أو على شبكة الإنترنت المحرر.

بإمكانك أيضًا استخدام Markdown في Google Docs من خلال تعديل إعداد واحد.