โปรแกรมแปลงข้อมูลจากไฟล์ CSV เป็นไฟล์ Markdown

ไฟล์ README คำอธิบาย pull request และเว็บไซต์เอกสารต่างแสดงตาราง Markdown ได้อย่างสวยงาม หากคุณยอมลงมือพิมพ์เครื่องหมายท่อ (|) และขีดคั่นด้วยตนเอง เครื่องแปลงนี้จะอ่านไฟล์ CSV โดยใช้แถวแรกเป็นหัวตาราง และสร้างตาราง GitHub Flavored Markdown พร้อมแถวคั่นที่ถูกต้อง ทุกเซลล์จะถูกล้อมรอบด้วยเครื่องหมายคั่น | พร้อมวางลงใน README หรือคำอธิบาย pull request

วิธีการสร้างตาราง

  1. 1

    วางไฟล์ CSV

    ค่าเริ่มต้นเป็นตัวอย่างแบบสามคอลัมน์ ให้เปลี่ยนเป็นข้อมูลของคุณเอง

  2. 2

    เลือกตัวแบ่งข้อมูล

    ค่าเริ่มต้นคือเครื่องหมายจุลภาค เลือกแท็บ อัฒภาค หรือเครื่องหมายท่อจากรายการให้ตรงกับข้อมูลของคุณ

  3. 3

    แถวที่ 1 เป็นหัวข้อ

    แถวแรกจะถูกแสดงเป็นหัวข้อ Markdown ตามด้วยบรรทัดแบ่ง `| --- | --- |` ที่จำเป็น

  4. 4

    แถวถูกเติมให้มีความกว้างเท่ากัน

    หากแถวข้อมูลมีจำนวนเซลล์น้อยกว่าจำนวนเซลล์ในส่วนหัวแถว ตัวแปลงจะเติมสตริงว่างเข้าไปเพื่อรักษารูปทรงของตารางให้เป็นสี่เหลี่ยมผืนผ้า

การเรนเดอร์ การจัดตำแหน่ง และข้อจำกัดในการทำงาน

ตาราง GitHub Flavored Markdown (GFM) ได้รับการรองรับอย่างแพร่หลาย แต่ยังไม่ใช่มาตรฐานสากล การรู้ว่าตารางเหล่านี้จะแสดงผลที่ใดได้บ้าง คือสิ่งที่แยกความต่างระหว่างไฟล์ README ที่ดูสะอาดตา กับกำแพงเครื่องหมายท่อที่อ่านยาก

รองรับใน

  • pull request และวิกิบน GitHub, GitLab และ Bitbucket
  • เครื่องมือสร้างเว็บไซต์แบบสแตติกส่วนใหญ่ (Docusaurus, VitePress, MkDocs Material)
  • การแสดงตัวอย่าง Markdown ใน VS Code
  • Notion (โดยการวางในรูปแบบ Markdown)

ไม่รองรับใน

  • CommonMark ที่ไม่มีส่วนขยาย GFM
  • Reddit (ใช้ชุดย่อยเฉพาะของตนเอง)
  • เครื่องมือวิกิรุ่นเก่าบางตัว (DokuWiki, MoinMoin)

การจัดแนวคอลัมน์

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

ไวยากรณ์ ผลลัพธ์
:--- ชิดซ้าย
:---: กึ่งกลาง
---: ชิดขวา

ให้ค้นหาและแทนที่แถวคั่นด้วย | :--- | :---: | ---: | ให้ตรงกับคอลัมน์ที่ต้องการจัดแนว

การใส่ตัวอักษรพิเศษในเซลล์ Markdown

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

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

ไม่ใช่โดยค่าเริ่มต้น แถวคั่นจะเป็น --- ธรรมดา ให้แทนที่ด้วย :---, :---: หรือ ---: หลังการแปลง เพื่อกำหนดให้คอลัมน์ชิดซ้าย กึ่งกลาง หรือชิดขวา

ให้ escape ด้วยแบ็กสแลชก่อนการแปลง โดยเปลี่ยน | เป็น \| มิฉะนั้นโปรแกรมแสดงผล Markdown จะถือว่าเป็นตัวคั่นคอลัมน์และทำให้ตารางเสีย

ตาราง GFM สามารถแสดงผลได้บน GitHub, GitLab, เครื่องมือสร้างเว็บไซต์แบบสถิตส่วนใหญ่ และ VS Code แต่ไม่สามารถแสดงผลได้บน CommonMark แบบธรรมดา, Reddit หรือวิกิบางประเภทที่ใช้งานมาอย่างยาวนานโดยไม่มีปลั๊กอิน

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

เครื่องมือที่เกี่ยวข้อง

ตารางอ้างอิง ASCII

ตาราง ASCII ครบตั้งแต่ 0 ถึง 127 พร้อมค่าเลขฐานสิบ ฐานสิบหก ฐานแปด ฐานสอง และรูปแบบการอ้างอิงอักขระแบบตัวเลขของ HTML รวม NUL, LF และ DEL

อ้างอิงตัวอักษร HTML

รายการที่สามารถค้นหาได้ขององค์ประกอบ HTML พร้อมรหัสชื่อและรหัสตัวเลข รวมถึงฟังก์ชันสำเนาด้วยคลิกเดียวสำหรับตัวอักษรพิเศษและสัญลักษณ์ต่างๆ

ตารางอ้างอิงแป้นพิมพ์ลัด

ค้นหาแป้นพิมพ์ลัดเริ่มต้นตามเอกสารของ VS Code, Chrome และ Bash ที่ใช้ GNU Readline บน macOS, Windows และ Linux

ตัวลดรูปพีชคณิตบูลีน

ประเมินนิพจน์บูลีนสำหรับทุกชุดอินพุตและดูตารางค่าความจริงที่สมบูรณ์ รองรับตัวแปรสูงสุดห้าตัวและตัวดำเนินการ &, |, !, ^

เครื่องสร้างตัวอักษรสุ่ม

สร้างตัวอักษร A-Z แบบสุ่ม เลือกจำนวน ตัวพิมพ์ใหญ่ ตัวพิมพ์เล็ก หรือแบบผสม แล้วใช้กับเกม โจทย์ หรือกิจกรรมในห้องเรียน

เครื่องมือตรวจสอบหมายเลขโทรศัพท์

ตรวจสอบโครงสร้างหมายเลขตามประเทศ พร้อมดูภูมิภาค ประเภท และรูปแบบ E.164 ระหว่างประเทศ ในประเทศ และ RFC 3966