เส้นแนวนอนใน Markdown: เส้นคั่น กฎ และการแก้ปัญหาที่พบบ่อย

หากต้องการเพิ่มเส้นแนวนอนใน Markdown ให้ใส่ขีดกลางสามตัวในบรรทัดแยก และเว้นบรรทัดว่างด้านบนและด้านล่าง:

จบส่วนแรก

---

เริ่มส่วนถัดไป

ผลลัพธ์คือเส้นคั่นระหว่างสองย่อหน้า Markdown เรียกสิ่งนี้ว่าการแบ่งหัวข้อ ส่วน HTML แทนด้วย <hr> วางตัวอย่างในตัวดู Markdownเพื่อตรวจเอกสารที่เรนเดอร์แล้ว

สามวิธีเขียนเส้นคั่น

รูปแบบต่อไปนี้ล้วนสร้างเส้นแบ่งหัวข้อ:

ต้นฉบับ Markdown	ผลลัพธ์
---	เส้นแนวนอน
***	เส้นแนวนอน
___	เส้นแนวนอน
* * *	เส้นแนวนอน

ใช้ขีดกลาง ดอกจัน หรือขีดล่างชนิดเดียวกันอย่างน้อยสามตัว มีช่องว่างระหว่างเครื่องหมายได้ การผสมชนิดเครื่องหมาย เพิ่มข้อความในบรรทัดเดียวกัน หรือใช้เพียงสองตัวจะไม่สร้างเส้น กฎเหล่านี้มาจากข้อกำหนดการแบ่งหัวข้อของ CommonMark

จำนวนขีดกลางไม่ได้กำหนดความกว้างที่แสดง ขีดกลาง 20 ตัวกับสามตัวสร้างองค์ประกอบ HTML เดียวกัน รูปแบบของปลายทางเป็นตัวกำหนดลักษณะเส้น

ทำไมเส้นแนวนอนจึงกลายเป็นหัวเรื่อง?

ต้นฉบับนี้ไม่ได้วางเส้นคั่นใต้ “บันทึกการอัปเดต”:

บันทึกการอัปเดต
---

มันสร้างหัวเรื่องระดับสอง ขีดกลางที่อยู่ถัดจากข้อความย่อหน้าทันทีอาจสร้างหัวเรื่องแบบ Setext และการตีความนี้มาก่อนเส้นแนวนอน เพิ่มบรรทัดว่างเพื่อแยกทั้งสองส่วน:

บันทึกการอัปเดต

---

สำหรับส่วนของเอกสาร การใช้หัวเรื่องที่ระบุชัดเจนมักเข้าใจง่ายกว่า:

## บันทึกการอัปเดต

ขั้นตอนนำเข้ารองรับไฟล์ CSV แล้ว

ใช้หัวเรื่อง Markdownเพื่อตั้งชื่อส่วน ใช้เส้นแนวนอนเมื่อการเปลี่ยนส่วนมีความหมาย เช่น การแยกจดหมายออกจากภาคผนวก

ทำไมเส้นคั่นจึงแสดงเป็นข้อความธรรมดา?

ตรวจต้นฉบับรอบเส้นคั่น:

อาการ	สาเหตุที่เป็นไปได้	วิธีแก้
ตัวอย่างแสดง --- ในบล็อกโค้ด	มีสี่ช่องว่างหน้าบล็อกแยก หรือยังไม่ปิดรั้วโค้ด	ลบการเยื้องหรือปิดรั้วโค้ด
ตัวอย่างแสดง --	มีขีดกลางเพียงสองตัว	ใช้สามตัวขึ้นไป
มีข้อความข้างเครื่องหมาย	บรรทัดนั้นมีข้อความอื่น	ใส่เครื่องหมายในบรรทัดแยก
แสดง --- อยู่ในประโยค	เครื่องหมายอยู่ในแบ็กทิก	เอาแบ็กทิกออกหากต้องการเส้นคั่น
ย่อหน้าก่อนหน้ากลายเป็นหัวเรื่อง	ไม่มีบรรทัดว่างเหนือ ---	เพิ่มบรรทัดว่าง

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

เส้นแนวนอนต่างจากการขึ้นบรรทัดใหม่

เส้นคั่นแบ่งส่วนของเอกสาร ไม่ได้เพียงเลื่อนคำถัดไปลงบรรทัดใหม่

สำหรับที่อยู่ ใช้การขึ้นบรรทัดใหม่แบบชัดเจน:

120 ถนนมาร์เก็ต\
ซานฟรานซิสโก รัฐแคลิฟอร์เนีย

หากต้องการย่อหน้าใหม่ ให้เว้นบรรทัดว่าง หากต้องการแบ่งส่วน ให้เขียน --- ในบรรทัดแยก คู่มือขึ้นบรรทัดใหม่ใน Markdownอธิบายช่องว่างท้ายบรรทัด แบ็กสแลช และพฤติกรรมขึ้นบรรทัดใหม่ที่ต่างกันของไฟล์กับความคิดเห็นใน GitHub

ใส่เส้นคั่นในข้อความอ้างอิง

คง > ไว้หน้าทุกบรรทัด รวมทั้งเส้นคั่นและบรรทัดว่าง:

> ข้อเสนอเดิม
>
> ---
>
> ข้อมูลเพิ่มเติมจากผู้ตรวจทาน

เส้นคั่นจะอยู่ในข้อความอ้างอิง การลบ > จากเส้นอาจจบข้อความอ้างอิงและย้ายเส้นออกไปยังเอกสารระดับนอก ดูตัวอย่างข้อความอ้างอิงสำหรับหลายย่อหน้าและการอ้างอิงซ้อนกัน

แถวคั่นตารางไม่ใช่เส้นแนวนอน

บรรทัดนี้เป็นส่วนหนึ่งของตาราง:

| รูปแบบ | แก้ไขได้ |
| --- | :---: |
| Markdown | ใช่ |

ไปป์และโคลอนที่เลือกใส่ได้ใช้บอกคอลัมน์ ไม่ได้สร้างเส้นคั่นเต็มหน้ากระดาษ ใช้เครื่องมือสร้างตาราง Markdownเพื่อสร้างตาราง หรือใช้ตัวแปลง CSV เป็น Markdownหากข้อมูลมีอยู่ในสเปรดชีตแล้ว

เส้นแนวนอนกับเอกสารที่ส่งออก

เส้นแบ่งหัวข้อไม่ใช่คำสั่งขึ้นหน้าใหม่ เครื่องมือส่งออก PDF หรือ Word กำหนดจุดสิ้นสุดหน้าจากเค้าโครงและกฎแบ่งหน้า อย่าเพิ่มขีดกลางโดยคาดว่าส่วนถัดไปจะเริ่มในหน้าใหม่

หากคุณควบคุม CSS ของเว็บเพจได้ สามารถปรับรูปแบบ <hr> ที่สร้างขึ้นในสไตล์ชีตของเว็บไซต์ บริการ Markdown แบบโฮสต์อาจไม่อนุญาต CSS ที่กำหนดเอง ตรวจปลายทางหรือเอกสารที่ส่งออก โดยเฉพาะเมื่อเส้นคั่นต้องคงความหมายหลังพิมพ์

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

ต้องเว้นบรรทัดว่างรอบเส้นแนวนอนหรือไม่?

CommonMark ไม่ได้บังคับในทุกบริบท แต่การเว้นช่วยหลีกเลี่ยงความกำกวมที่ --- กลายเป็นหัวเรื่อง และทำให้ต้นฉบับอ่านง่ายขึ้น

ใช้แท็ก hr ของ HTML ได้หรือไม่?

<hr> ใช้ได้ในตัวเรนเดอร์ที่อนุญาต HTML ดิบ แต่ --- เหมาะกับเอกสาร Markdown มากกว่า ตัวแก้ไข MD File Viewer ลบแท็ก HTML ที่ผู้ใช้ใส่ ขณะที่ไวยากรณ์เส้นคั่น Markdown แสดงได้ตามปกติ

จะแสดงขีดกลางสามตัวโดยไม่สร้างเส้นคั่นได้อย่างไร?

หากเป็นตัวอย่างไวยากรณ์ ให้ใช้โค้ดในบรรทัด: `---` หากต้องการข้อความธรรมดาในบรรทัดแยก ให้เอสเคปขีดกลางตัวแรก: \---

รูปแบบอื่นที่ใช้บ่อยดูได้ในสรุปไวยากรณ์ Markdown