WebGroundwebground.app
معلومات وأدلة · مرجع للمطورين

مرجع Markdown السريع مع معاينة مباشرة

تعلّم صياغة Markdown للعناوين والقوائم والروابط والجداول وكتل الشيفرة من مرجع سريع، ثم جرّبها في محرر بمعاينة مباشرة.

محرر بمعاينة مباشرة

٥٩٨ / ٢٠٬٠٠٠

المعاينة

مرحباً بك في Markdown

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

القوائم
  • العنصر الأول

  • العنصر الثاني

    • عنصر متداخل

  1. الخطوة الأولى

  2. الخطوة الثانية

  • مهمة منجزة

  • مهمة مفتوحة

اقتباس ورابط وجدول

ينبغي أن تكون الأشياء البسيطة بسيطة.

اقرأ المزيد على example.com.

الفاكهةالسعر
تفاح1.20
كمثرى0.90
js
function greet(name) {
  return "Hello, " + name;
}

صورة نموذجية

تعمل المعاينة داخل متصفحك. تُعرض شيفرة HTML الخام كنص، وتظهر الصور كعناصر نائبة، ولا يمكن النقر إلا على روابط http وhttps وmailto.

مرجع الصياغة

عرض ٣٠ من ٣٠
  • **bold text**
    الوظيفة
    نص عريض. ويصلح أيضاً استخدام شرطتين سفليتين على كل جانب.
  • *italic text*
    الوظيفة
    نص مائل. وتصلح أيضاً شرطة سفلية واحدة على كل جانب.
  • ***bold and italic***
    الوظيفة
    نص عريض ومائل معاً، باستخدام ثلاث علامات نجمة.
  • ~~crossed out~~
    الوظيفة
    نص يمر خط في وسطه، باستخدام علامتي تلدة على كل جانب.
  • First paragraph. Second paragraph.
    الوظيفة
    اترك سطراً فارغاً بين كتل النص لبدء فقرة جديدة.
  • First line\ Second line
    الوظيفة
    شرطة مائلة عكسية في نهاية السطر، أو مسافتان هناك، تبدأ سطراً جديداً داخل الفقرة نفسها.
  • \*not italic\*
    الوظيفة
    الشرطة المائلة العكسية قبل رمز من رموز Markdown تعرض الرمز نفسه.
  • # Heading 1
    الوظيفة
    عنوان من المستوى الأول. ضع مسافة بعد علامة #.
  • ## Heading 2
    الوظيفة
    عنوان من المستوى الثاني، للأقسام الرئيسية.
  • ### Heading 3
    الوظيفة
    عنوان من المستوى الثالث، للأقسام الفرعية.
  • ###### Heading 6
    الوظيفة
    أصغر عنوان. تتدرج المستويات من علامة # واحدة إلى ست علامات.
  • Heading 1 ========= Heading 2 ---------
    الوظيفة
    أسلوب بديل: ضع تحت النص سطراً من علامات المساواة للمستوى 1 أو من الشرطات للمستوى 2.
  • - First item - Second item - Third item
    الوظيفة
    قائمة نقطية. ابدأ كل سطر بشرطة أو علامة نجمة أو علامة زائد.
  • 1. First item 2. Second item 3. Third item
    الوظيفة
    قائمة مرقّمة. ابدأ كل سطر برقم تليه نقطة.
  • - Parent item - Child item - Child item
    الوظيفة
    أزِح العنصر بمسافتين أو أكثر لجعله متداخلاً تحت العنصر الذي فوقه.
  • - [x] Finished task - [ ] Open task
    الوظيفة
    قائمة مهام بمربعات محددة وغير محددة.
  • [link text](https://example.com)
    الوظيفة
    رابط يُكتب نصه الظاهر بين قوسين معقوفين وعنوانه بين قوسين.
  • [link text](https://example.com "Tooltip")
    الوظيفة
    رابط مع تلميح يُكتب بين علامتي اقتباس بعد العنوان.
  • <https://example.com>
    الوظيفة
    القوسان الزاويان يحوّلان عنوان الويب إلى رابط.
  • الوظيفة
    القوسان الزاويان يحوّلان عنوان البريد الإلكتروني إلى رابط بريد.
  • ![alt text](https://example.com/image.png)
    الوظيفة
    صورة. تُكتب كالرابط مع علامة تعجب في أوله؛ ويصف النص الذي بين القوسين المعقوفين الصورة.
  • `inline code`
    الوظيفة
    شيفرة داخل جملة، محاطة بعلامات الاقتباس العكسية (backtick).
  • `` code with a ` backtick ``
    الوظيفة
    استخدم علامتي اقتباس عكسيتين متتاليتين عندما تحتوي الشيفرة نفسها على علامة اقتباس عكسية.
  • ``` code block ```
    الوظيفة
    كتلة شيفرة بين سطرين يحتوي كل منهما على ثلاث علامات اقتباس عكسية. ويبقى النص داخلها كما كُتب.
  • ```js console.log("Hi"); ```
    الوظيفة
    أضف اسم اللغة بعد علامات الاقتباس العكسية الافتتاحية لتتمكن المحررات من تلوين الشيفرة.
  • > Quoted text
    الوظيفة
    نص مقتبس. ابدأ السطر بعلامة «أكبر من».
  • > Quoted text >> Nested quote
    الوظيفة
    أضف علامة «أكبر من» أخرى لاقتباس داخل اقتباس.
  • ---
    الوظيفة
    خط فاصل. ضع ثلاث شرطات أو علامات نجمة أو شرطات سفلية أو أكثر في سطر مستقل.
  • | Name | Qty | | --- | --- | | Apple | 3 | | Pear | 5 |
    الوظيفة
    جدول. افصل الأعمدة بخطوط عمودية وضع صفاً من الشرطات تحت صف العناوين.
  • | Left | Center | Right | | :--- | :---: | ---: | | a | b | c |
    الوظيفة
    النقطتان الرأسيتان في الصف الفاصل تحاذيان العمود إلى اليسار أو الوسط أو اليمين.

ما هي Markdown

لغة Markdown طريقة لكتابة مستندات منسّقة بنص عادي. فبضعة رموز تُكتب حول الكلمات العادية تحدد العناوين والتوكيد والقوائم والروابط والشيفرة، ويبقى النص مقروءاً حتى قبل تحويله.

تُستخدم في ملفات README والتوثيق وتطبيقات تدوين الملاحظات ورسائل المحادثة وكثير من أدوات التدوين. ويعرض المحرر أعلاه كيف يظهر كل عنصر من عناصر الصياغة أثناء الكتابة.

نصائح لكتابة Markdown نظيفة

تنشأ معظم المشكلات من المسافات لا من الرموز نفسها.

  • ضع مسافة بعد علامات # في العنوان وبعد علامة عنصر القائمة.
  • اترك سطراً فارغاً قبل العناوين والقوائم والاقتباسات وكتل الشيفرة وبعدها.
  • أزِح عناصر القائمة المتداخلة لتصطف مع نص العنصر الذي فوقها.
  • ضع شرطة مائلة عكسية قبل رمز مثل * أو _ ليظهر كما هو.

الأسئلة الشائعة

هل تبدو Markdown متطابقة في كل مكان؟+

الأساسيات نعم. فالعناوين والتوكيد والقوائم والروابط والشيفرة تتبع معيار CommonMark في كل مكان تقريباً. أما الجداول وقوائم المهام والنص المشطوب فهي امتدادات شاعت بفضل GitHub، لذا لا تدعمها بعض التطبيقات.

لماذا لا تشغّل المعاينة شيفرة HTML ولا تحمّل صوري؟+

المعاينة محدودة عن قصد. تُعرض شيفرة HTML الخام كنص، وتظهر الصور كعناصر نائبة تحمل وصفها بدلاً من تنزيلها، ولا يمكن النقر إلا على روابط http وhttps وmailto.

هل يُرسل النص الذي أكتبه إلى أي مكان؟+

لا. تُنشأ المعاينة داخل متصفحك، ولا يُرفع النص ولا يُحفظ.

استكشف المزيد على WebGround

عرض الكل