โปรแกรมสร้างตารางแบบ Markdown

ไวยากรณ์ตารางใน Markdown

ตารางพื้นฐาน:

| คอลัมน์ A | คอลัมน์ B | คอลัมน์ C |
|-----------|-----------|-----------|
| เซลล์ 1   | เซลล์ 2   | เซลล์ 3   |
| เซลล์ 4   | เซลล์ 5   | เซลล์ 6   |

การจัดแนวใช้เครื่องหมายทวิภาค (:) ในแถวที่ใช้แยกข้อมูล:

| ซ้าย | กึ่งกลาง | ขวา |
|:-----|:--------:|----:|
| a    | b        | c   |

• :--- จัดชิดซ้าย
• :---: จัดกึ่งกลาง
• ---: จัดชิดขวา

สิ่งที่เครื่องมือทำให้คุณ

• ปรับขนาดของแต่ละเซลล์ให้เท่ากับความกว้างของข้อมูลที่ยาวที่สุดในคอลัมน์ เพื่อให้เครื่องหมายท่อจัดเรียงตรงกันในไฟล์ต้นฉบับ ไม่มีผลต่อผลลัพธ์ที่แสดงผล, เพราะ Markdown จะละเว้นช่องว่างที่เกินมา, แต่ผู้อ่านที่ตรวจสอบความแตกต่าง (diff) จะขอบคุณคุณแน่นอน
• หลีกเลี่ยง (escape) เครื่องหมายท่อภายในเซลล์เป็น \| เพื่อป้องกันไม่ให้เซลล์ที่มี a|b แยกออกเป็นสองคอลัมน์
• ช่วยรักษาการจัดเรียงตำแหน่งให้คงที่เมื่อคุณเปลี่ยนความกว้างของคอลัมน์
• รองรับการวางข้อมูลในรูปแบบ CSV และ TSV; สามารถตรวจจับฟิลด์ที่มีเครื่องหมายอ้างอิง และเครื่องหมายจุลภาคภายในเครื่องหมายอ้างอิงได้

ข้อผิดพลาดที่พบบ่อย

• แถวแบ่งข้อมูลเป็นสิ่งจำเป็น ตารางในรูปแบบ Markdown ที่ไม่มีแถว |---|---| จะถูกแสดงเป็นข้อความธรรมดา
• ไม่มีเซลล์ที่มีหลายบรรทัด แต่ละแถวคือหนึ่งบรรทัด หากต้องการหยุดแสดงข้อมูลภายในตาราง ให้ใส่ <br> เนื่องจากไม่รองรับการแยกบรรทัดด้วย Markdown ภายในเซลล์ตาราง
• ห้ามใช้ตารางแบบซ้อนกัน หากจำเป็นควรใช้ HTML แทน
• เซลล์ที่ว่าง ต้องมีช่องว่าง (หรืออย่างน้อยก็ควรมีคู่ของเครื่องหมายท่อที่ว่างเปล่า) โปรดหลีกเลี่ยงการใช้ || โดยตรง

เมื่อใดควรใช้ HTML แทน

หากคุณต้องการใช้ค่า colspan, rowspan เซลล์ที่มีหลายบรรทัด หรือคลาส CSS แบบกำหนดเอง ตารางใน HTML ถือเป็นเครื่องมือที่เหมาะสมที่สุด โดยโปรแกรมแปลงข้อความ Markdown ส่วนใหญ่สามารถรับโค้ดตาราง HTML ดิบได้โดยตรงในรูปแบบ inline

จุดที่ตารางใน Markdown ทำงานได้ดี

• เอกสารแนะนำ (README) ของ GitHub, GitLab และ Gitea
• คำอธิบายเกี่ยวกับปัญหาและประเด็นประชาสัมพันธ์
• แอป Obsidian, Bear และแอปจดบันทึกส่วนใหญ่
• Docusaurus, MkDocs และ Hugo ล้วนรองรับตาราง GFM