การอ้างอิง Markdown ของ Microsoft

Microsoft Q&A สนับสนุนประสบการณ์การใช้งานตัวแก้ไขเว็บที่หลากหลาย ดังนั้นคุณจะไม่ต้องกังวลเกี่ยวกับการแก้ไขเนื้อหาใน Markdown ในกรณีที่คุณทําเช่นนั้น นี่คือการอ้างอิงสําหรับการเขียน Markdown สําหรับ Q & A

Markdown คือ ภาษามาร์กอัปน้ำหนักเบาพร้อมไวยากรณ์การจัดรูปแบบข้อความธรรมดา learn.microsoft.com(Learn) สนับสนุน CommonMark โดยเป็นไปตามข้อกําหนดของ Markdown ที่แยกวิเคราะห์ผ่านเครื่องมือวิเคราะห์คํา 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);
            }

อิโมจิ

Q&A จะแปลงรหัสย่ออีโมจิเป็นอักขระ 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).`

ลิงก์ข้อความ

คําที่คุณใส่ไว้ในข้อความลิงก์ควรเป็นมิตร กล่าวคือ ข้อความลิงก์ควรเป็นคำภาษาอังกฤษปกติหรือชื่อของหน้าเว็บที่คุณกำลังเชื่อมโยงไปถึง

อย่าใช้ "เลือกที่นี่" สําหรับ "ข้อความลิงก์" คำนี้ไม่เหมาะสำหรับการปรับให้เหมาะสมสำหรับโปรแกรมค้นหา และไม่อธิบายเป้าหมายอย่างเพียงพอ

ตัวอย่าง:

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

ตัวอย่างข้างต้นแสดงผลเป็น:

สําหรับข้อมูลเพิ่มเติม โปรดดูที่หน้าผลิตภัณฑ์ถามตอบของ Microsoft

ลิงก์อัตโนมัติ

ลิงก์จะถูกจัดรูปแบบโดยอัตโนมัติสําหรับสตริงใด ๆ ที่เริ่มต้นโดย: , https://, , , หรือ www. (แก้ไขเป็น https://www) tel:mailto:ftp://https://

รายการ (ลําดับเลข มีสัญลักษณ์แสดงหัวข้อย่อย)

รายการลำดับเลข

เมื่อต้องการสร้างรายการที่มีหมายเลข คุณสามารถใช้ 1s ทั้งหมดได้ ตัวเลขจะแสดงผลตามลำดับจากน้อยไปหามากเป็นรายการตามลำดับเมื่อเผยแพร่ สําหรับความยากง่ายในการอ่านของแหล่งข้อมูลที่เพิ่มขึ้น คุณสามารถเพิ่มรายการของคุณด้วยตนเอง

ห้ามใช้ตัวอักษรในรายการ รวมถึงรายการแบบซ้อน รายการจะไม่แสดงอย่างถูกต้องเมื่อถูกเผยแพร่ รายการที่ซ้อนกันที่ใช้ตัวเลขจะแสดงเป็นอักษรตัวพิมพ์เล็กเมื่อถูกเผยแพร่ ตัวอย่างเช่น:

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

จะแสดงดังต่อไปนี้:

1. นี่คือ
2. รายการลําดับเลข parent
   1. และนี่คือ
   2. รายการลำดับเลขซ้อน
3. (fin)

รายการมีสัญลักษณ์แสดงหัวข้อย่อย

เพื่อสร้างรายการมีสัญลักษณ์แสดงหัวข้อย่อย ให้ใช้ - หรือ * ตามด้วยช่องว่างในตอนต้นของแต่ละบรรทัด:

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

จะแสดงดังต่อไปนี้:

• นี่คือ
• รายการมีสัญลักษณ์แสดงหัวข้อย่อย parent
  • และนี่คือ
  • รายการมีสัญลักษณ์แสดงหัวข้อย่อยซ้อน
• ทั้งหมดเสร็จสิ้น!

ไม่ว่าคุณจะใช้ - ไวยากรณ์หรือ *ใช้ในลักษณะใดในเนื้อหาของคุณอย่างสม่ําเสมอ

ตาราง

วิธีที่ง่ายที่สุดในการสร้างตารางใน Markdown คือ ใช้ไปป์และเส้น เพื่อสร้างตารางมาตรฐานพร้อมส่วนหัว ให้ตามเส้นแรกด้วยเส้นประ:

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

จะแสดงดังต่อไปนี้: