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