ไวยากรณ์หัวข้อ Markdown
หัวข้อเป็นองค์ประกอบที่สำคัญที่สุดในการจัดโครงสร้างเอกสาร Markdown รองรับไวยากรณ์หัวข้อสองประเภท: สไตล์ ATX และสไตล์ Setext
หัวข้อสไตล์ ATX
เพื่อสร้างหัวข้อ ให้เพิ่มเครื่องหมาย hash (#) ไว้หน้าคำหรือวลี จำนวนเครื่องหมาย hash แสดงระดับของหัวข้อ
# หัวข้อระดับ 1
## หัวข้อระดับ 2
### หัวข้อระดับ 3
#### หัวข้อระดับ 4
##### หัวข้อระดับ 5
###### หัวข้อระดับ 6ผลการแสดงผล
หัวข้อระดับ 1
หัวข้อระดับ 2
หัวข้อระดับ 3
หัวข้อระดับ 4
หัวข้อระดับ 5
หัวข้อระดับ 6
ไวยากรณ์การปิดแบบเลือกได้
คุณสามารถ "ปิด" หัวข้อสไตล์ ATX ได้ตามต้องการ ซึ่งใช้เพื่อความสวยงามเท่านั้น:
# หัวข้อระดับ 1 #
## หัวข้อระดับ 2 ##
### หัวข้อระดับ 3 ###จำนวน # ที่ท้ายบรรทัดไม่จำเป็นต้องเท่ากับส่วนหัว จำนวนเครื่องหมาย hash ที่ส่วนหัวกำหนดระดับของหัวข้อ
หัวข้อสไตล์ Setext
ยังสามารถเพิ่มเครื่องหมาย = จำนวนเท่าใดก็ได้ไว้ใต้ข้อความเพื่อระบุหัวข้อระดับ 1 หรือเครื่องหมาย - เพื่อระบุหัวข้อระดับ 2
หัวข้อระดับ 1
========
หัวข้อระดับ 2
--------ผลการแสดงผล
หัวข้อระดับ 1
หัวข้อระดับ 2
แนวทางปฏิบัติที่ดีที่สุดสำหรับหัวข้อ
การพิจารณาเรื่องความเข้ากันได้
เมื่อไม่มีช่องว่างระหว่างเครื่องหมาย hash (#) และข้อความหัวข้อ แอปพลิเคชัน Markdown แต่ละตัวจะจัดการต่างกัน เพื่อความเข้ากันได้ โปรดเพิ่มช่องว่างหนึ่งช่องระหว่างเครื่องหมาย hash และข้อความหัวข้อ
| ✅ แนะนำ | ❌ ไม่แนะนำ |
|---|---|
# นี่คือหัวข้อ | #นี่คือหัวข้อ |
การใช้บรรทัดว่าง
เพื่อความเข้ากันได้ โปรดเพิ่มบรรทัดว่างทั้งก่อนและหลังหัวข้อ
นี่คือข้อความย่อหน้า
# นี่คือหัวข้อ
นี่คือข้อความย่อหน้าอื่นระดับหัวข้อ
- แต่ละเอกสารแนะนำให้ใช้หัวข้อระดับ 1 เพียงหนึ่งตัว
- รักษาเหตุผลของระดับหัวข้อ อย่าข้ามระดับ
- หัวข้อควรสะท้อนโครงสร้างลำดับชั้นของเอกสาร
มาตรฐานข้อความหัวข้อ
- ข้อความหัวข้อกระชับและชัดเจน
- หลีกเลี่ยงการใช้เครื่องหมายวรรคตอน (โดยเฉพาะจุด)
- ใช้คำกริยานามหรือวลีคำนาม
- รักษารูปแบบหัวข้อระดับเดียวกันให้สอดคล้องกัน
เอาต์พุต HTML
หัวข้อ Markdown จะถูกแปลงเป็นแท็กหัวข้อ HTML ที่เกี่ยวข้อง:
# หัวข้อ → <h1>หัวข้อ</h1>
## หัวข้อ → <h2>หัวข้อ</h2>
### หัวข้อ → <h3>หัวข้อ</h3>
#### หัวข้อ → <h4>หัวข้อ</h4>
##### หัวข้อ → <h5>หัวข้อ</h5>
###### หัวข้อ → <h6>หัวข้อ</h6>ID หัวข้อ (ฟีเจอร์ขยาย)
โปรเซสเซอร์ Markdown หลายตัวจะสร้าง ID สำหรับหัวข้อโดยอัตโนมัติ เพื่อสร้างลิงก์จุดยึด:
<h1 id="markdown-ไวยากรณ์หัวข้อ">ไวยากรณ์หัวข้อ Markdown</h1>ด้วยวิธีนี้คุณสามารถลิงก์ไปยังหัวข้อเฉพาะได้:
[ลิงก์ไปยังหัวข้อ](#markdown-ไวยากรณ์หัวข้อ)ตัวอย่างการใช้งานจริง
นี่คือตัวอย่างเอกสารที่แสดงโครงสร้างหัวข้อที่ดี:
# คู่มือการใช้งานผลิตภัณฑ์
## เริ่มต้นอย่างรวดเร็ว
### ขั้นตอนการติดตั้ง
#### ข้อกำหนดระบบ
#### การดาวน์โหลดและการติดตั้ง
### การกำหนดค่าพื้นฐาน
## ฟีเจอร์ขั้นสูง
### การตั้งค่าแบบกำหนดเอง
### การจัดการปลั๊กอิน
## การแก้ปัญหา
### คำถามที่พบบ่อย
### ติดต่อฝ่ายสนับสนุนโครงสร้างหัวข้อที่จัดลำดับชั้นอย่างชัดเจนนี้ทำให้เอกสารง่ายต่อการอ่านและนำทาง