เครื่องมือนี้ทำอะไร
การพิมพ์ตาราง Markdown เองน่าเบื่อมาก ทุกแถวต้องมีขีดตั้ง แถวที่สองต้องมีขีดกลาง และการจัดคอลัมน์ให้ตรงด้วยมือก็ใช้เวลานาน เครื่องมือนี้แปลงข้อมูล CSV หรือ TSV เป็นตาราง GitHub Flavored Markdown ที่นำไปวางใน README, pull request, issue, หน้า wiki หรือเอกสาร Markdown ใดก็ได้
CSV ถูกแยกวิเคราะห์อย่างถูกต้อง จึงรองรับฟิลด์ในเครื่องหมายคำพูดที่มีจุลภาค เครื่องหมายคำพูดที่เขียนซ้ำ และเซลล์หลายบรรทัด ผลลัพธ์จะถูกเติมช่องว่างให้คอลัมน์ตรงกันแม้ในข้อความธรรมดา ทำให้อ่านและแก้ไขตารางภายหลังได้ง่าย
วิธีใช้
- วาง CSV หรือ TSV อัปโหลดไฟล์
.csvหรือ.tsvหรือกด ตัวอย่าง - เลือก การจัดแนว: ค่าเริ่มต้น ชิดซ้าย กึ่งกลาง ชิดขวา หรือ ตัวเลขชิดขวา เพื่อให้คอลัมน์ที่มีแต่ตัวเลขชิดขวา
- เปิด แถวแรกเป็นหัวตาราง ไว้หากแถวแรกเป็นชื่อคอลัมน์ ไม่เช่นนั้นหัวตารางจะเป็น Column 1, Column 2 ไปเรื่อย ๆ
- ปิด จัดคอลัมน์ให้ตรง หากต้องการแถวแบบกะทัดรัดโดยไม่เติมช่องว่าง
- คัดลอกตารางหรือดาวน์โหลดเป็นไฟล์
.md
แถวที่มีเซลล์น้อยกว่าหัวตารางจะถูกเติมด้วยเซลล์ว่าง ตารางจึงถูกต้องเสมอ
ตัวอย่าง
CSV นี้:
Tool,Stars,Notes
ripgrep,48000,"Fast, recursive search"
fd,34000,find | but friendlierเมื่อเลือก ตัวเลขชิดขวา จะกลายเป็นตาราง Markdown ดังนี้:
| Tool | Stars | Notes |
| ------- | ----: | ---------------------- |
| ripgrep | 48000 | Fast, recursive search |
| fd | 34000 | find \| but friendlier |จุลภาคในฟิลด์ที่อยู่ในเครื่องหมายคำพูดยังอยู่ในเซลล์ ขีดตั้งถูก escape และคอลัมน์ตัวเลขได้เครื่องหมาย --: จึงชิดขวาเมื่อแสดงผล
เคล็ดลับ
- เครื่องหมายจัดแนวในแถวที่สอง (
:--,:-:,--:) กำหนดการจัดแนวของแต่ละคอลัมน์ในตารางที่แสดงผล - Markdown แบบอินไลน์ในเซลล์ เช่น
**ตัวหนา**โค้ดอินไลน์ หรือลิงก์ จะถูกเก็บไว้และตัวแสดงผลส่วนใหญ่แสดงได้ - ตารางที่กว้างมากอ่านยากบนหน้าจอเล็ก ลองแยกคอลัมน์ออกเป็นหลายตาราง
- หากต้องการสร้างตาราง HTML หรือแปลงอาร์เรย์ JSON เป็นตาราง Markdown ให้ใช้เครื่องมือที่เกี่ยวข้องด้านล่าง
คำถามที่พบบ่อย
› ตารางใช้ Markdown แบบไหน
ตารางแบบขีดตั้งของ GitHub Flavored Markdown (GFM) ซึ่ง GitLab, Bitbucket, Notion, Obsidian, Docusaurus, MkDocs และตัวสร้างเว็บไซต์สถิตส่วนใหญ่รองรับเช่นกัน CommonMark ล้วนไม่มีไวยากรณ์ตาราง
› ขีดตั้งและการขึ้นบรรทัดใหม่ในเซลล์จะเป็นอย่างไร
ขีดตั้งจะทำให้เซลล์สิ้นสุด จึงเขียนเป็น \| ภายในแถวของตารางขึ้นบรรทัดใหม่ไม่ได้ การขึ้นบรรทัดใหม่จึงกลายเป็นแท็ก <br> ซึ่ง GitHub และตัวแสดงผลส่วนใหญ่แสดงเป็นการขึ้นบรรทัดใหม่
› ทำไมคอลัมน์ภาษาจีน ญี่ปุ่น หรือเกาหลีจึงตรงกัน
เมื่อเปิดจัดคอลัมน์ให้ตรง เซลล์จะถูกเติมช่องว่างตามความกว้างที่แสดงผล อักขระเอเชียตะวันออกแบบกว้างนับเป็นสองคอลัมน์ Markdown ดิบจึงยังตรงกันในเอดิเตอร์ที่ใช้ฟอนต์ความกว้างคงที่ ส่วนตารางที่แสดงผลแล้วจะเหมือนกันทั้งสองแบบ
› แปลง TSV ที่คัดลอกจาก Excel หรือ Google ชีตได้ไหม
ได้ เซลล์ที่คัดลอกจากสเปรดชีตจะคั่นด้วยแท็บ และตัวคั่นจะถูกตรวจหาอัตโนมัติ หรือจะเลือก Tab เองก็ได้