مرجع Microsoft Q&A Markdown

يدعم Microsoft Q&A تجربة محرر ويب غنية، لذلك لن تقلق أبدا بشأن تحرير المحتوى في Markdown. في حالة القيام بذلك، إليك مرجع لكتابة Markdown ل Q&A.

Markdown هي لغة ترميز خفيفة الوزن مع بناء جملة تنسيق نص عادي. learn.microsoft.com (Learn) يدعم Markdown المتوافق مع CommonMark الذي تم تحليله من خلال محرك تحليل Markdig . يدعم Learn وQ&A أيضا ملحقات Markdown المخصصة التي توفر محتوى أكثر ثراء على الموقع. يستخدم Q&A مجموعة فرعية من الملحقات المدعومة في وثائق Learn. توفر هذه المقالة مرجعا أبجديا.

يمكنك الاطلاع على مزيد من المعلومات حول مقالة مرجع Learn Markdown.

قصاصات برمجية

حظر الاقتباس

> This example is a blockquote. It's usually rendered indented and with a different background color.

يعرض المثال السابق كما يلي:

هذا هو blockquote. عادة ما يتم عرضه بمسافة بادئة ولون خلفية مختلف.

كتل التعليمات البرمجية

يمكنك إضافة لغة التعليمات البرمجية إلى كتلة التعليمات البرمجية لتقديم أكثر ثراء.

```csharp
    public static void Log(string message)
            {
                _logger.LogInformation(message);
            }
    ```

يعرض المثال السابق كما يلي:

    public static void Log(string message)
            {
                _logger.LogInformation(message);
            }

رموز المشاعر

س&حول رمز مشاعر قصير إلى أحرف Unicode الخاصة به:

This is a test with a :).

يعرض المثال السابق كما يلي:

هذا اختبار مع 😃.

تنسيق

لتنسيق النص بتنسيق غامق، قم بإحاطته بعلامة نجمية:

This text is **bold**.

لتنسيق النص كمائل، قم بإحاطته بعلامة نجمية واحدة:

This text is *italic*.

لتنسيق النص كغامق ومائل على حد سواء، قم بإحاطته بثلاث علامات نجمية:

This text is both ***bold and italic***.

لتنسيق النص كضربة ، قم بإحاطته باثنين يحيطان به باثنين من التلدسات:

This text is ~~strikeout~~.

الرؤوس

يدعم Q&A ستة مستويات من عناوين Markdown:

# This is a first level heading (H1)

## This is a second level heading (H2)

...

###### This is a sixth level heading (H6)

• يجب أن تكون هناك مسافة بين نص العنوان والأخير # .
• يجب أن يكون لكل سؤال أو إجابة أو تعليق عنوان H1 واحد فقط.

HTML

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

الصور

يدعم ملحق Learn المخصص :::image::: الصور القياسية والصور المعقدة والأيقونات.

:::image source="<folderOrURLPath>" alt-text="<alt text>":::

حيث <alt text> هو وصف مختصر للصورة وهو <folderOrURLPath> مسار نسبي للصورة أو عنوان URL الخاص بها. النص البديل مطلوب لقارئات الشاشة لضعاف البصر. كما أنه مفيد إذا كان هناك خطأ في الموقع حيث لا يمكن عرض الصورة. لا تنسخ أسماء الملفات لاستخدامها كنص بديل. على سبيل المثال، بدلا من هذا:

:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="ADextension_2FA_Configure_Step4":::

اكتب هذا:

:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="Active Directory extension for two-factor authentication, step 4: Configure":::

الارتباطات

من السهل إضافة الارتباطات في Q&A. تشير ارتباطات المستخدمين إلى محتوى صفحة أخرى في Q&A أو مصدر موثوق آخر.

[Link text](<FullURL>).

[Microsoft Q&A products page](/answers/products).`

نص الارتباط

يجب أن تكون الكلمات التي تقوم بتضمينها في نص الارتباط مألوفة. بمعنى آخر، يجب أن تكون كلمات إنجليزية عادية أو عنوان الصفحة التي تقوم بالارتباط بها.

لا تستخدم "تحديد هنا". ل "ارتباط النص". إنها سيئة لتحسين محرك البحث ولا تصف الهدف بشكل كاف.

هام

يجب أن تكون جميع الارتباطات آمنة (https مقابل http) كلما كان الهدف يدعمها (والتي يجب أن تدعمها الغالبية العظمى).

مثال:

For more information, see the [Microsoft Q&A products page](/answers/products).

يعرض المثال أعلاه على النحو التالي:

لمزيد من المعلومات، راجع صفحة منتجات Microsoft Q&A.

ارتباطات تلقائية

سيتم تنسيق الارتباطات تلقائيا لأي سلسلة تبدأ ب: https://أو https://أو ftp://tel:mailto:www. (يتم حلها إلى https://www.)

القوائم (ذات تعداد رقمي، نقطي)

قائمة مرقمة

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

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

1. This is
1. a parent numbered list
   1. and this is
   1. a nested numbered list
1. (fin)

يتم عرض هذا على النحو التالي:

1. هذا يكون
2. قائمة ذات تعداد رقمي أصلي
   1. وهذا
   2. قائمة ذات تعداد رقمي متداخل
3. (fin)

قائمة نقطية

لإنشاء قائمة نقطية، استخدم - مسافة أو * متبوعة بها في بداية كل سطر:

- This is
- a parent bulleted list
  - and this is
  - a nested bulleted list
- All done!

يتم عرض هذا على النحو التالي:

• هذا يكون
• قائمة نقطية أصلية
  • وهذا
  • قائمة نقطية متداخلة
• تم كل شيء!

أيا كان بناء الجملة الذي تستخدمه، - أو *، استخدمه باستمرار في المحتوى الخاص بك.

الجداول

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

|This is   |a simple   |table header|
|----------|-----------|------------|
|table     |data       |here        |
|it doesn't|actually   |have to line up nicely!|

يتم عرض هذا على النحو التالي:

هذا يكون	بسيط	رأس الجدول
طاولتنا	البيانات	هنا
لا	فعلا	يجب أن تصطف بشكل جيد!