Skip to content

ไวยากรณ์หัวข้อ Markdown

หัวข้อเป็นองค์ประกอบที่สำคัญที่สุดในการจัดโครงสร้างเอกสาร Markdown รองรับไวยากรณ์หัวข้อสองประเภท: สไตล์ ATX และสไตล์ Setext

หัวข้อสไตล์ ATX

เพื่อสร้างหัวข้อ ให้เพิ่มเครื่องหมาย hash (#) ไว้หน้าคำหรือวลี จำนวนเครื่องหมาย hash แสดงระดับของหัวข้อ

markdown
# หัวข้อระดับ 1
## หัวข้อระดับ 2  
### หัวข้อระดับ 3
#### หัวข้อระดับ 4
##### หัวข้อระดับ 5
###### หัวข้อระดับ 6

ผลการแสดงผล

หัวข้อระดับ 1

หัวข้อระดับ 2

หัวข้อระดับ 3

หัวข้อระดับ 4

หัวข้อระดับ 5
หัวข้อระดับ 6

ไวยากรณ์การปิดแบบเลือกได้

คุณสามารถ "ปิด" หัวข้อสไตล์ ATX ได้ตามต้องการ ซึ่งใช้เพื่อความสวยงามเท่านั้น:

markdown
# หัวข้อระดับ 1 #
## หัวข้อระดับ 2 ##
### หัวข้อระดับ 3 ###

จำนวน # ที่ท้ายบรรทัดไม่จำเป็นต้องเท่ากับส่วนหัว จำนวนเครื่องหมาย hash ที่ส่วนหัวกำหนดระดับของหัวข้อ

หัวข้อสไตล์ Setext

ยังสามารถเพิ่มเครื่องหมาย = จำนวนเท่าใดก็ได้ไว้ใต้ข้อความเพื่อระบุหัวข้อระดับ 1 หรือเครื่องหมาย - เพื่อระบุหัวข้อระดับ 2

markdown
หัวข้อระดับ 1
========

หัวข้อระดับ 2
--------

ผลการแสดงผล

หัวข้อระดับ 1

หัวข้อระดับ 2

แนวทางปฏิบัติที่ดีที่สุดสำหรับหัวข้อ

การพิจารณาเรื่องความเข้ากันได้

เมื่อไม่มีช่องว่างระหว่างเครื่องหมาย hash (#) และข้อความหัวข้อ แอปพลิเคชัน Markdown แต่ละตัวจะจัดการต่างกัน เพื่อความเข้ากันได้ โปรดเพิ่มช่องว่างหนึ่งช่องระหว่างเครื่องหมาย hash และข้อความหัวข้อ

✅ แนะนำ❌ ไม่แนะนำ
# นี่คือหัวข้อ#นี่คือหัวข้อ

การใช้บรรทัดว่าง

เพื่อความเข้ากันได้ โปรดเพิ่มบรรทัดว่างทั้งก่อนและหลังหัวข้อ

markdown
นี่คือข้อความย่อหน้า

# นี่คือหัวข้อ

นี่คือข้อความย่อหน้าอื่น

ระดับหัวข้อ

  • แต่ละเอกสารแนะนำให้ใช้หัวข้อระดับ 1 เพียงหนึ่งตัว
  • รักษาเหตุผลของระดับหัวข้อ อย่าข้ามระดับ
  • หัวข้อควรสะท้อนโครงสร้างลำดับชั้นของเอกสาร

มาตรฐานข้อความหัวข้อ

  • ข้อความหัวข้อกระชับและชัดเจน
  • หลีกเลี่ยงการใช้เครื่องหมายวรรคตอน (โดยเฉพาะจุด)
  • ใช้คำกริยานามหรือวลีคำนาม
  • รักษารูปแบบหัวข้อระดับเดียวกันให้สอดคล้องกัน

เอาต์พุต HTML

หัวข้อ Markdown จะถูกแปลงเป็นแท็กหัวข้อ HTML ที่เกี่ยวข้อง:

markdown
# หัวข้อ       →  <h1>หัวข้อ</h1>
## หัวข้อ      →  <h2>หัวข้อ</h2>
### หัวข้อ     →  <h3>หัวข้อ</h3>
#### หัวข้อ    →  <h4>หัวข้อ</h4>
##### หัวข้อ   →  <h5>หัวข้อ</h5>
###### หัวข้อ  →  <h6>หัวข้อ</h6>

ID หัวข้อ (ฟีเจอร์ขยาย)

โปรเซสเซอร์ Markdown หลายตัวจะสร้าง ID สำหรับหัวข้อโดยอัตโนมัติ เพื่อสร้างลิงก์จุดยึด:

html
<h1 id="markdown-ไวยากรณ์หัวข้อ">ไวยากรณ์หัวข้อ Markdown</h1>

ด้วยวิธีนี้คุณสามารถลิงก์ไปยังหัวข้อเฉพาะได้:

markdown
[ลิงก์ไปยังหัวข้อ](#markdown-ไวยากรณ์หัวข้อ)

ตัวอย่างการใช้งานจริง

นี่คือตัวอย่างเอกสารที่แสดงโครงสร้างหัวข้อที่ดี:

markdown
# คู่มือการใช้งานผลิตภัณฑ์

## เริ่มต้นอย่างรวดเร็ว

### ขั้นตอนการติดตั้ง

#### ข้อกำหนดระบบ

#### การดาวน์โหลดและการติดตั้ง

### การกำหนดค่าพื้นฐาน

## ฟีเจอร์ขั้นสูง

### การตั้งค่าแบบกำหนดเอง

### การจัดการปลั๊กอิน

## การแก้ปัญหา

### คำถามที่พบบ่อย

### ติดต่อฝ่ายสนับสนุน

โครงสร้างหัวข้อที่จัดลำดับชั้นอย่างชัดเจนนี้ทำให้เอกสารง่ายต่อการอ่านและนำทาง

ไวยากรณ์ที่เกี่ยวข้อง

สร้างโดย www.markdownlang.com