โปรแกรมแปลงข้อมูลจากไฟล์ 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 จะถูกส่งไปยังเซิร์ฟเวอร์ของเราเพื่อให้เครื่องแปลงสร้างตารางได้ ไฟล์จะไม่ถูกจัดเก็บและไม่ถูกเพิ่มลงในลิงก์ของหน้า
เครื่องมือที่เกี่ยวข้อง
ตัวสร้างการตั้งค่า Webpack
สร้างไฟล์ webpack.config.js สำหรับ webpack 5 จากแบบฟอร์มสั้นๆ ตั้งค่า entry, โฟลเดอร์ output และ mode จากนั้นเปิด TypeScript, Babel, CSS loader, HtmlWebpackPlugin และ dev server
ตัวแปลง Timestamp
แปลง timestamp ของ Unix ในหน่วยวินาทีหรือมิลลิวินาทีเป็นวันที่ที่อ่านง่ายในเขตเวลา UTC และเขตเวลาหลัก และแปลงวันที่กลับเป็นค่า epoch
ตารางอ้างอิง ASCII
ตาราง ASCII ครบตั้งแต่ 0 ถึง 127 พร้อมค่าเลขฐานสิบ ฐานสิบหก ฐานแปด ฐานสอง และรูปแบบการอ้างอิงอักขระแบบตัวเลขของ HTML รวม NUL, LF และ DEL
เครื่องสุ่มที่อยู่
สร้างระเบียนคล้ายที่อยู่ 1–20 รายการสำหรับแบบจำลองและการทดสอบ ด้วยรูปแบบประเทศแบบย่อ
ตัวลดรูปพีชคณิตบูลีน
ประเมินนิพจน์บูลีนสำหรับทุกชุดอินพุตและดูตารางค่าความจริงที่สมบูรณ์ รองรับตัวแปรสูงสุดห้าตัวและตัวดำเนินการ &, |, !, ^
ตัวสร้างลูกศร CSS
สร้างลูกศร CSS ในเบราว์เซอร์ด้วยทิศทาง สี ขนาด และความหนาของเส้นขอบ แล้วคัดลอกกฎ.
เครื่องมือนี้มีให้บริการในภาษาอื่น
- Konwerter CSV na Markdown [PL]
- CSV till Markdown-omvandlare [SV]
- CSVからMarkdownへの変換ツール [JA]
- Chuyển đổi từ CSV sang Markdown [VI]
- CSV zu Markdown Konverter [DE]
- CSV → Markdown 변환기 [KO]
- Conversor de CSV para Markdown [PT]
- Convertidor de CSV a Markdown [ES]
- محول CSV إلى Markdown [AR]
- Konverter CSV ke Markdown [ID]
- CSV naar Markdown Converter [NL]
- Convertisseur CSV en Markdown [FR]
- CSV to Markdown Converter [EN]
- Convertitore da CSV a Markdown [IT]
- Конвертер CSV в Markdown [RU]
- CSV'den Markdown'a Çevirici [TR]
- CSV到Markdown转换器 [ZH]