חומר עזר בנושא סימון שאלות ותשובות של Microsoft

שאלות ותשובות של Microsoft תומכות בחוויה עשירה של עורך אינטרנט, כך שלעולם לא תצטרך לדאוג לגבי עריכת התוכן ב- Markdown. במקרה זה, הנה הפניה לכתובת Markdown עבור שאלות ותשובות.

Markdown היא שפת סימון קלילה עם תחביר עיצוב טקסט רגיל. learn.microsoft.com (Learn) תומך בניתוח Markdown תואם CommonMark באמצעות מנגנון הניתוח Markdig . Learn ו- Q&A תומכים גם בהרחבות Markdown מותאמות אישית המספקות תוכן עשיר יותר באתר. שאלות ותשובות משתמשות בערכת משנה של ההרחבות הנתמכות בתיעוד של Learn. מאמר זה מספק חומר עזר בסדר אלפביתי.

תוכל לראות מידע נוסף על מאמר העיון של Learn Markdown .

מקטעי קוד

חסום ציטוט

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

הדוגמה הקודמת מעובדת באופן הבא:

זהו בלוק ציטוט. בדרך כלל הוא מעובד מוסט פנימה עם צבע רקע שונה.

בלוקי קוד

באפשרותך להוסיף את שפת הקוד לבלוק קוד לעיבוד עשיר יותר.

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

הדוגמה הקודמת מעובדת באופן הבא:

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

סמלי Emoji

Q&A ימיר קוד קצר של Emoji לתווי ה- 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~~.

כותרות

שאלות ותשובות תומכות בשש רמות של כותרות 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, התוכן לא יעובד. במקום זאת, הוא יוצג כטקסט רגיל.

תמונות

ההרחבה המותאמת :::image::: אישית Learn תומכת בתמונות רגילות, בתמונות מורכבות ובמלים.

:::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":::

קישורים

קל להוסיף קישורים ב שאלות ותשובות. קישורים להצביע על תוכן דף אחר ב'שאלות ותשובות' או במקור מהימן אחר.

[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://, , mailto:ftp://, , tel:או www. (נפתר ל- https://www.)

רשימות (ממוספרות, עם תבליטים)

רשימה ממוספרת

כדי ליצור רשימה ממוספרת, באפשרותך להשתמש בכל 1. המספרים מעובדים בסדר עולה כרשימה רציפה בעת פרסום. כדי לשפר את מידת הקריאות של המקור, באפשרותך להגדיל את הרשימות באופן ידני.

אל תשתמש באותיות ברשימות, כולל רשימות מקוננות. הם אינם מעובדים כראוי בעת פרסומנו. רשימות מקוננות המשתמשות במספרים יעובדו כאותיות קטנות בעת פרסום. לדוגמה:

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

פעולה זו מעובדת באופן הבא:

1. זהו
2. רשימה ממוספרת של אב
   1. וזה
   2. רשימה ממוספרת מקוננת
3. (זרוע) היי, היי

רשימה עם תבליטים

כדי ליצור רשימה עם תבליטים - , השתמש * או לאחר מכן ברווח בתחילת כל שורה:

- 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!|

פעולה זו מעובדת באופן הבא:

זהו	פשוט	כותרת טבלה
שולחן	נתונים	כאן
הוא לא	בעצם	צריך בשורה יפה!