เครื่องมือสร้างตาราง Markdown

จริง ๆ แล้วตาราง Markdown คืออะไร

ตาราง Markdown ไม่ได้เป็นส่วนหนึ่งของข้อกำหนด Markdown ดั้งเดิม แต่มาจาก GitHub Flavored Markdown ซึ่งเป็นภาษาถิ่นที่ GitHub ทำให้เป็นที่นิยมและตอนนี้รองรับแทบทุกที่ที่นักพัฒนาเขียนงาน ไวยากรณ์ของมันเป็นข้อความธรรมดาโดยเจตนา คอลัมน์ถูกคั่นด้วยอักขระขีดตั้ง แถวหัวตารางอยู่ด้านบน และแถวที่สองที่เป็นเครื่องหมายขีดจะแบ่งหัวตารางออกจากเนื้อหา เพราะมันเป็นเพียงข้อความ ตาราง Markdown จึงยังคงอ่านง่ายในรูปแบบดิบ และอยู่รอดผ่านการคัดลอกวาง การเทียบความต่างใน version control และอีเมล ได้ในแบบที่ตาราง HTML ไม่มีทางทำได้

เครื่องมือนี้ขจัดความน่าเบื่อในการจัดเรียงขีดตั้งเหล่านั้น คุณวางแถวข้อมูลธรรมดาลงไป มันจะคำนวณคอลัมน์ให้ และเขียนตารางที่ถูกต้องสมบูรณ์ พร้อมหัวตาราง แถวตัวแบ่ง และทุกเซลล์เข้าที่

กายวิภาคของไวยากรณ์

ตารางขั้นต่ำสุดมีลักษณะเป็นสามบรรทัด บรรทัดแรกแสดงรายการหัวตารางที่คั่นด้วยขีดตั้ง เช่น Name แล้วขีดตั้ง แล้ว Role บรรทัดที่สองคือตัวแบ่ง เป็นกลุ่มของเครื่องหมายขีดหนึ่งกลุ่มต่อหนึ่งคอลัมน์ เช่น ขีดสามตัว ขีดตั้ง ขีดสามตัว ทุกบรรทัดหลังจากนั้นเป็นแถวข้อมูลที่ใช้รูปแบบขีดตั้งเดียวกัน ขีดตั้งด้านนอกที่ต้นและท้ายของแต่ละบรรทัดเป็นทางเลือกใน GFM แต่การใส่มันเข้าไปทำให้ข้อความดิบอ่านง่ายขึ้น และเป็นสิ่งที่เครื่องสร้างนี้ผลิตออกมา

แถวตัวแบ่งทำหน้าที่สองอย่าง มันทั้งบ่งบอกว่าบรรทัดด้านบนเป็นหัวตาราง และผ่านการวางตำแหน่งของเครื่องหมายทวิภาค มันประกาศว่าแต่ละคอลัมน์จัดแนวอย่างไร นี่จึงเป็นเหตุผลที่ตาราง Markdown ต้องมีอย่างน้อยหนึ่งแถวหัวตารางและหนึ่งแถวตัวแบ่งเสมอ จึงจะแสดงผลได้เลย

การตั้งค่าการจัดแนวคอลัมน์

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

การเลือกชิดซ้าย กึ่งกลาง หรือชิดขวาในเครื่องมือนี้จะเขียนเครื่องหมายทวิภาคเหล่านั้นให้คุณตลอดทั้งตาราง ซึ่งหมายความว่าการจัดแนวจะแสดงผลเหมือนกันบน GitHub ในเครื่องสร้างเอกสาร และในโปรแกรมดู GFM อื่น ๆ แทนที่จะขึ้นอยู่กับการตั้งค่าของผู้อ่าน

ตัวอย่างจริงที่ลงมือทำ

วางสามบรรทัดที่คั่นด้วยจุลภาค ได้แก่ Name, Role, City ด้านบน ตามด้วย Ada Lovelace, Engineer, London และ Grace Hopper, Admiral, New York เมื่อเลือกการจัดแนวกึ่งกลาง เครื่องมือจะออกแถวหัวตารางที่มีสามหัวเรื่อง แถวตัวแบ่งที่ขีดของแต่ละคอลัมน์ถูกห่อด้วยทวิภาค และแถวข้อมูลสองแถว เมื่อวางลงในไฟล์ README บน GitHub มันจะแสดงผลเป็นตารางสามคอลัมน์ที่เรียบร้อยพร้อมค่าที่จัดกึ่งกลาง โดยไม่ต้องนับขีดตั้งด้วยมือ

การใส่อักขระหลีกให้ขีดตั้งและข้อควรระวังอื่น ๆ

ขีดตั้งเป็นตัวคั่นคอลัมน์ ดังนั้นขีดตั้งจริง ๆ ที่อยู่ในเซลล์ตามปกติแล้วจะแบ่งเซลล์นั้นออกเป็นสองและทำลายตาราง เครื่องมือนี้จะใส่อักขระหลีกให้ขีดตั้งในข้อมูลของคุณโดยอัตโนมัติ ด้วยการเขียนมันเป็นแบ็กสแลชตามด้วยขีดตั้ง ดังนั้นค่าอย่างนิพจน์ตรรกะที่มีสัญลักษณ์ OR จึงยังคงอยู่ในเซลล์เดียวและแสดงผลตามที่ตั้งใจไว้

มีอีกสองสิ่งที่ควรรู้ ตาราง Markdown ไม่สามารถมีการขึ้นบรรทัดแบบบังคับภายในเซลล์ด้วยการกดปุ่ม Enter ได้ หากคุณต้องการขึ้นบรรทัดภายในเซลล์ คุณต้องแทรกแท็ก br อย่างชัดเจน เนื่องจาก GFM อนุญาตให้ใช้ HTML แบบ inline และทุกแถวควรมีจำนวนคอลัมน์เท่ากับหัวตาราง เซลล์ที่เกินมาในแถวจะถูกตัวเรนเดอร์ส่วนใหญ่มองข้าม และเซลล์ที่ขาดไปจะแสดงผลเป็นช่องว่าง ดังนั้นจงทำให้แถวของคุณเป็นสี่เหลี่ยมเสมอ เพื่อผลลัพธ์ที่คาดเดาได้

ตัวคั่นและค่าที่อยู่ในเครื่องหมายคำพูด

ข้อมูลจริงไม่ได้มาในรูปแบบที่คั่นด้วยจุลภาคเสมอไป การปล่อยตัวคั่นไว้ที่อัตโนมัติช่วยให้เครื่องมือตรวจจับว่าแถวของคุณใช้จุลภาค แท็บ หรือขีดตั้ง ซึ่งหมายความว่าบล็อกที่คัดลอกมาจากสเปรดชีตโดยตรง (คั่นด้วยแท็บ) และไฟล์ CSV ที่ส่งออกมา (คั่นด้วยจุลภาค) ต่างก็แปลงได้โดยไม่ต้องตั้งค่า คุณยังบังคับตัวคั่นเฉพาะได้เมื่อการตรวจจับอัตโนมัติอาจเดาผิด เช่น ข้อมูลที่มีจุลภาคจำนวนมากอยู่จริง

ค่า CSV ที่อยู่ในเครื่องหมายคำพูดก็ถูกจัดการอย่างถูกต้องเช่นกัน จุลภาคที่อยู่ภายในเครื่องหมายคำพูดคู่จะถูกถือเป็นส่วนหนึ่งของค่า ดังนั้นฟิลด์อย่างรายการที่ขึ้นต้นด้วยนามสกุลในเครื่องหมายคำพูดจึงยังคงอยู่ในเซลล์เดียวแทนที่จะแตกออกเป็นสองคอลัมน์ เรื่องนี้สำคัญเพราะการส่งออกจากสเปรดชีตมักใส่เครื่องหมายคำพูดให้ค่าใดก็ตามที่มีตัวคั่นอยู่ในตัวเองเป็นประจำ

ตาราง Markdown ใช้ได้ที่ไหน และใช้ไม่ได้ที่ไหน

ตาราง Markdown โดดเด่นในบริบทของนักพัฒนาและงานเขียน ทั้งไฟล์ README, อิชชู และ pull request บน GitHub และ GitLab เครื่องสร้างเว็บไซต์แบบ static และเอกสาร วิกิและแอปจดบันทึกจำนวนมาก เครื่องมือแชตอย่าง Slack และ Discord ในฟิลด์ที่รองรับ Markdown และความคิดเห็นบน Reddit ที่ใดก็ตามที่รองรับ GFM ตารางที่วางลงไปก็ใช้งานได้เลยและยังคงอ่านง่ายในรูปแบบต้นฉบับ

แต่มันก็ไม่ได้ใช้ได้ทุกที่ Markdown ธรรมดาที่ไม่มีส่วนขยาย GFM ไม่เข้าใจตาราง และตัวเรนเดอร์ขนาดเบาบางตัวก็มองข้ามมันไป ในกรณีนั้นขีดตั้งดิบ ๆ จะปรากฏให้เห็น ตาราง Markdown ยังขาดการควบคุมการจัดสไตล์อย่างละเอียด การผสานเซลล์ และโครงสร้างซ้อน เมื่อคุณต้องการการจัดรูปแบบที่แม่นยำ การรวมคอลัมน์ หรือการจัดสไตล์ที่หรูหรา ตาราง HTML เป็นตัวเลือกที่ดีกว่า เมื่อคุณต้องการตารางที่สะอาด ควบคุมเวอร์ชันได้ และอ่านง่ายสำหรับคน Markdown เป็นฝ่ายชนะ