markdown tables gfm reference

Markdown Tables: คู่มือที่ครบถ้วนสําหรับ GFM Table Syntax

ทุกอย่างเกี่ยวกับตาราง Markdown GFM การประกอบการ, การจัดแถว, ตารางที่ซับซ้อน, การแสดงความแปลก และวิธีการสร้างมันจากเอกสาร Word

W
WordToMD ทีม
·

ตาราง Markdown ให้คุณแสดงข้อมูลที่มีโครงสร้างในรูปแบบที่สามารถอ่านได้ที่ทําเป็นตาราง HTML คู่มือนี้ครอบคลุม GFM (GitHub สร้างสรรพคุณ Markdown) ตารางการเขียน, ตัวเลือกการสอดคล้อง, รูปแบบที่พัฒนา, และวิธีการแปลงตาราง Word เป็น Markdown.

Basic Table Syntax (ประโยคตารางพื้นฐาน)

ตาราง Markdown มี 3 ส่วน:

  1. เส้นหัวข้อ ชื่อคอลัมน์
  2. แถวแยก รางที่มีท่อ, กําหนดตาราง
  3. แถวข้อมูล เนื้อหา
| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Row 1, Col 1 | Row 1, Col 2 | Row 1, Col 3 |
| Row 2, Col 1 | Row 2, Col 2 | Row 2, Col 3 |

การแสดงผลเป็น:

คอลัมน์ 1คอลัมน์ที่ 2คอลัมน์ 3
แถวที่ 1 คอล์ม 1แถวที่ 1 คอล์มที่ 2แถวที่ 1 คอลล์ 3
แถวที่ 2 คอล์ม 1แถวที่ 2 คอล์มที่ 2แถวที่ 2 คอลล์ 3

การจัดเรียงคอลัมน์

ใช้คอลอนในแถวแยกเพื่อควบคุมการจัดสรร

| Left aligned | Center aligned | Right aligned |
|:---|:---:|---:|
| text | text | text |
| longer text | longer text | longer text |
ซ้ายตรงกันกลางตรงกันตรงขวา
texttexttext
ข้อความยาวข้อความยาวข้อความยาว
  • :--- จัดตั้งซ้าย (ปกติ)
  • :---: จัดตรงกลาง
  • ---: จัดตรงขวา

การจัดรูปแบบภายในเซลล์ตาราง

การจัดรูปแบบ Inline Markdown ส่วนใหญ่จะทํางานภายในเซลล์ตาราง:

| Element | Example |
|---|---|
| Bold | **bold text** |
| Italic | *italic text* |
| Code | `inline code` |
| Link | [click here](https://wordtomd.org) |
| Strikethrough | ~~deleted~~ |

สิ่งที่ไม่ทํางาน: เนื้อหาหลายแถว, รายการที่วางตัว, องค์ประกอบระดับบล็อก.

ตัวอักษรท่อในเซลล์

ถ้าคุณต้องการท่อจริงๆ | ภายในเซลล์, หนีมันด้วย backslash:

| Flag | Description |
|---|---|
| `x \| y` | Bitwise OR operator |

ตารางที่ไม่มีช่องว่าง

การวางระยะระหว่างท่อเป็นทางเลือก นี้เป็นจริง:

|Column 1|Column 2|
|---|---|
|Cell|Cell|

แต่การวางระยะที่สอดคล้อง ทําให้ตารางอ่านง่ายขึ้น บรรณาธิการและนักเขียนส่วนใหญ่ชอบรูปแบบที่สเปซ

เซลล์ว่าง

ปล่อยช่องว่างระหว่างท่อว่างสําหรับเซลล์ว่าง:

| A | B | C |
|---|---|---|
| content | | content |
| | content | |

การแปลงตาราง Word เป็น Markdown

Word ตารางแปลงโดยอัตโนมัติเมื่อคุณใช้ WordToMD. The converter handles:

  • ตารางท่อมาตรฐาน → GFM
  • ความกว้างของคอลัมน์ → มาตรฐาน (Markdown ไม่ควบคุมความกว้างของคอลัมน์)
  • การออกแบบข้อความภายในเซลล์ → เก็บไว้ ( bold, italic, links)

อะไรที่ไม่เปลี่ยน

  • เซลล์ผสมผสาน (colspan/rowspan) ล้มลงไปยังเซลล์ที่ใกล้ที่สุด
  • เนื้อหาเซลล์หลายแถว เส้นตัดขาด
  • โต๊ะที่ตั้ง โต๊ะภายในที่เรียบ

การจัดการตารางที่ซับซ้อน Word

เซลล์รวม

Words เซลล์รวมไม่มี Markdown เทียบเท่า. ตัวเลือก

  1. การปรับปรุงโครงสร้างใหม่ แยกแถวรวมเป็นตารางแยก
  2. ใช้ HTML ส่วนใหญ่ Markdown โปรเซสเซอร์ยอมรับ HTML table syntax:
<table>
  <tr>
    <th colspan="2">Merged Header</th>
  </tr>
  <tr>
    <td>Cell 1</td>
    <td>Cell 2</td>
  </tr>
</table>

เนื้อหาเซลล์หลายแถว

การใช้ <br> สําหรับการตัดสายภายในเซลล์ (ทํางานบน GitHub และส่วนใหญ่ของแพลตฟอร์ม)

| Step | Description |
|---|---|
| 1 | Open the file<br>Make sure it's .docx format |
| 2 | Drop it on [WordToMD](/#converter) |

โต๊ะใหญ่

สําหรับตารางที่มีคอลัมน์หลายคอลัมน์ ลองพิจารณาว่าตารางเป็นรูปแบบที่เหมาะสมหรือไม่ อัลตรานติก

  • รายการนิยาม (คํา + คําอธิบาย)
  • ตารางขนาดเล็กหลายรายละเอียดตามประเภท
  • โบล็อกโค้ดสําหรับข้อมูลที่มีโครงสร้าง (JSON, YAML)

การแสดงตารางตามแพลตฟอร์ม

แพลตฟอร์มGFM ตารางการปรับปรุงHTML ตาราง
GitHub✅✅✅
GitLab✅✅✅
Notion✅❌❌
Obsidian✅✅✅
GitBook✅✅✅
VS รูปแบบรหัส✅✅✅
Confluence (Markdown แมคโร)✅✅✅
Jekyll/Hugo/Astro✅✅✅

การเข้าถึง

เพื่อให้การเข้าถึงได้ดีขึ้น การันตีว่าตารางมีแถวหัวข้อที่มีชื่อคอลัมน์ที่มีความหมาย เครื่องอ่านหน้าจอใช้แถวหัวข้อเพื่อประกาศกรอบเซลล์

| Product | Price | Availability |
|---|---|---|
| Widget A | $9.99 | In stock |
| Widget B | $14.99 | Out of stock |

หลีกเลี่ยงการใช้ตารางเพื่อการวางแผน ใช้มันเพียงสําหรับข้อมูลตารางจริง

FAQ

ทําไมตารางของผมไม่ให้การแสดง มันแสดงเป็นข้อความธรรมดา? เส้นแยก ( |---|---| หมวดนี้เป็นการบังคับใช้ โดยไม่มีมัน, parser จะไม่ยอมรับโครงสร้างตาราง.

ฉันขอโต๊ะที่ไม่มีหัวข้อได้มั้ย? ไม่อยู่ใน GFM มาตรฐาน ต้องการเส้นหัวหน้าและแยก หากคุณไม่ต้องการหัวข้อที่เห็นได้ ใช้หัวข้อเปล่า: | | | ด้วยแถวแยก

ทําไมตารางของฉันจาก Word ดูถูกใน WordToMD แต่ผิดหลังจากที่ผมติดมันไว้ที่อื่น? ปัญหานี้มักจะตามพื้นที่ขาวในเซลล์หรือตัวอักษรที่ไม่สอดคล้อง การทําการแสดงออก Markdown ส่วนใหญ่จะอ่อนโยน แต่การสําเนาและติดอาจนําตัวอักษรที่มองไม่เห็นมา

ผมสร้างตารางได้อย่างไร จากข้อมูลโดยโปรแกรม? ห้องสมุด เช่น markdown-table (npm) หรือ Pythons tabulate สามารถสร้างตาราง Markdown จากอาร์เรย์ได้ นี้เป็นประโยชน์สําหรับการแปลง batch CSV หรือข้อมูลฐานข้อมูล.

การสรุป

ตาราง Markdown มีพลังในการแสดงข้อมูลที่มีโครงสร้าง และได้รับการสนับสนุนอย่างแพร่หลายในทุกแพลตฟอร์มหลัก สําหรับตารางที่เริ่มด้วย Word WordToMD แปลงมันเป็น GFM syntax สําหรับการวางแผนที่ซับซ้อน, การ HTML การสํารองและอุปกรณ์ด้านบน ให้คุณการควบคุมที่คุณต้องการ.