การอ้างอิง 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).`
ลิงก์ข้อความ
คําที่คุณใส่ไว้ในข้อความลิงก์ควรเป็นมิตร กล่าวคือ ข้อความลิงก์ควรเป็นคำภาษาอังกฤษปกติหรือชื่อของหน้าเว็บที่คุณกำลังเชื่อมโยงไปถึง
อย่าใช้ "เลือกที่นี่" สําหรับ "ข้อความลิงก์" คำนี้ไม่เหมาะสำหรับการปรับให้เหมาะสมสำหรับโปรแกรมค้นหา และไม่อธิบายเป้าหมายอย่างเพียงพอ
สำคัญ
ลิงก์ทั้งหมดต้องปลอดภัย (https
vs http
) เมื่อใดก็ตามที่เป้าหมายสนับสนุน (ซึ่งส่วนใหญ่ควรให้การสนับสนุน)
ตัวอย่าง:
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)
จะแสดงดังต่อไปนี้:
- นี่คือ
- รายการลําดับเลข parent
- และนี่คือ
- รายการลำดับเลขซ้อน
- (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!|
จะแสดงดังต่อไปนี้:
นี่คือ | อย่างง่าย | ส่วนหัวของตาราง |
---|---|---|
ตาราง | ข้อมูล | ที่นี่ |
มันไม่ | จริง ๆ แล้ว | ต้องเรียงแถวสวยงาม! |