วิธีใช้งาน
- พิมพ์หัวตารางในแถวแรกและข้อมูลด้านล่าง หรือเปิด “เติมจาก CSV…” แล้ววางเซลล์จากสเปรดชีต
- เพิ่มหรือลบแถวและคอลัมน์ด้วยปุ่มต่าง ๆ
- ตั้งค่าการจัดแนวของแต่ละคอลัมน์ด้วยเมนูด้านบน
- เลือก Markdown หรือ HTML แล้วคัดลอกหรือดาวน์โหลดตาราง
วิธีการทำงาน
เอาต์พุต Markdown เป็นไปตามไวยากรณ์ตารางของ GitHub Flavored Markdown (GFM) ซึ่ง GitHub, GitLab, โปรแกรมสร้างเอกสารจำนวนมาก และโปรแกรมแก้ไข Markdown ส่วนใหญ่รองรับ แถวแรกจะกลายเป็นส่วนหัว ตามด้วยแถวตัวคั่นที่กำหนดการจัดแนว: :--- สำหรับชิดซ้าย, :---: สำหรับกึ่งกลาง, ---: สำหรับชิดขวา และ --- สำหรับค่าเริ่มต้น
เนื้อหาในเซลล์จะถูก escape เพื่อไม่ให้ตารางเสียหาย: ตัว | ในเซลล์จะถูกเขียนเป็น \| และการขึ้นบรรทัดใหม่จะกลายเป็น <br> เนื่องจากแถวตาราง GFM ต้องอยู่ภายในบรรทัดเดียว Markdown อื่นในเซลล์ เช่น **ตัวหนา** หรือ `code` จะถูกเก็บไว้และแสดงผลโดยโปรแกรมดู Markdown เมื่อเลือก "จัดแนวคอลัมน์ด้วยช่องว่าง" ทุกคอลัมน์จะถูกเติมให้กว้างเท่ากัน เพื่อให้อ่านตารางเป็นข้อความล้วนได้ง่าย อักขระภาษาจีน ญี่ปุ่น หรือเกาหลี นับเป็นความกว้างสองคอลัมน์ แถวที่มีเซลล์น้อยกว่าจะถูกเติมด้วยเซลล์ว่าง
การนำเข้ารองรับข้อความคั่นด้วยแท็บ (แบบที่สเปรดชีตคัดลอกใส่คลิปบอร์ด), CSV ที่คั่นด้วยจุลภาคหรืออัฒภาค รวมถึงฟิลด์ในเครื่องหมายคำพูดที่มีจุลภาค เครื่องหมายคำพูด และการขึ้นบรรทัดใหม่ และตาราง Markdown ที่มีอยู่แล้ว ซึ่งจะอ่านแถวการจัดแนวด้วย
เอาต์พุต HTML เป็น <table> ธรรมดาพร้อม <thead> และ <tbody> ข้อความถูก escape แบบ HTML (& < > ") การขึ้นบรรทัดใหม่กลายเป็น <br> และการจัดแนวกำหนดด้วย inline style ของ text-align เพื่อให้ทำงานได้โดยไม่ต้องใช้สไตล์ชีต
ตัวอย่าง
สเปรดชีตสู่ README
เลือกช่วงข้อมูลใน Google Sheets คัดลอก แล้ววางลงในช่องนำเข้า แล้วคลิก “เติมตาราง” ตั้งคอลัมน์ราคาให้ชิดขวา แล้วคัดลอก Markdown ไปใส่ใน README.md
ข้อความที่มีอักขระ pipe
เซลล์ที่มีข้อความ “Unlimited | fair use” จะถูกเขียนเป็น Unlimited \| fair use GitHub จึงแสดงเครื่องหมาย pipe แทนการเริ่มคอลัมน์ใหม่
จัดระเบียบตารางที่มีอยู่
วางตาราง Markdown ที่เขียนเองโดยเว้นระยะไม่เท่ากัน คลิก “เติมตาราง” แล้วคัดลอกผลลัพธ์กลับไป โดยทุกคอลัมน์เรียงตรงกันและการจัดแนวยังคงอยู่
คำถามที่พบบ่อย
เซลล์สามารถมีการขึ้นบรรทัดใหม่ได้ไหม
ไม่เป็นการขึ้นบรรทัดใหม่จริง เนื่องจากแต่ละแถวของตารางต้องอยู่ในบรรทัดเดียวใน Markdown เครื่องมือนี้จะเขียน <br> แทน ซึ่ง GitHub และโปรแกรมดูส่วนใหญ่จะแสดงผลเป็นการขึ้นบรรทัดใหม่
ทำไมต้องมีแถวส่วนหัว
ตาราง GFM เริ่มต้นด้วยแถวส่วนหัว แล้วตามด้วยแถวกำหนดการจัดแนวเสมอ หากไม่ต้องการให้เห็นหัวข้อ คุณสามารถปล่อยเซลล์ส่วนหัวว่างไว้ได้ แต่โปรแกรมดูส่วนใหญ่ยังคงแสดงเส้นแบ่งหัวตาราง
รวมเซลล์ได้หรือไม่
ไม่ได้ ตาราง Markdown ไม่รองรับการรวมเซลล์ (colspan หรือ rowspan) หากต้องการใช้ ให้ใช้เอาต์พุต HTML แล้วเพิ่มแอตทริบิวต์ colspan หรือ rowspan เอง
การจัดระยะห่างมีผลกับลักษณะตารางเมื่อแสดงผลหรือไม่
ไม่ การเว้นวรรคพิเศษจะถูกมองข้ามเมื่อแสดงผล Markdown การจัดระยะช่วยให้อ่านและแก้ไขซอร์สได้ง่ายขึ้นเท่านั้น
ความเป็นส่วนตัว
ตารางถูกสร้างขึ้นในเบราว์เซอร์ของคุณเท่านั้น ข้อมูลที่คุณพิมพ์หรือวางจะไม่ถูกอัปโหลด จัดเก็บ หรือรวมอยู่ในข้อมูลวิเคราะห์