Markdown Tabel: Panduan Lengkap untuk GFM Syntax Tabel

Tabel Markdown memungkinkan Anda menampilkan data terstruktur dalam format yang dapat dibaca yang merender sebagai tabel HTML. Panduan ini mencakup GFM (GitHub Rasa Markdown) sintaksis tabel, opsi penyelarasan, pola lanjutan, dan cara mengkonversi tabel Word ke Markdown.

Sintaksis Tabel Dasar

Tabel Markdown terdiri dari tiga bagian:

1. Baris header nama kolom
2. Baris pemisahan dashes dengan pipa, mendefinisikan tabel
3. Baris data isi

| 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 |

Render sebagai:

Pencocokan Kolom

Gunakan titik di baris pemisah untuk mengontrol keselarasan:

| Left aligned | Center aligned | Right aligned |
|:---|:---:|---:|
| text | text | text |
| longer text | longer text | longer text |

• :--- Alihan kiri (default)
• :---: Menyaring pusat
• ---: Selaras kanan

Memformatting Di Dalam Sel-sel Tabel

Sebagian besar pemformatan inline Markdown bekerja di dalam sel tabel:

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

Apa yang tidak berhasil: konten multi-baris, daftar yang tertanam, elemen tingkat blok.

Karakter pipa dalam sel

Jika Anda membutuhkan pipa harfiah | di dalam sel, melarikan diri dengan backslash:

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

Tabel Tanpa Jarak

Menjaga jarak di sekitar pipa adalah opsional. Ini berlaku:

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

Tapi jarak yang konsisten membuat tabel lebih mudah dibaca. Sebagian besar editor dan linter lebih memilih format jarak.

Sel-sel kosong

Tinggalkan ruang antara pipa kosong untuk sel kosong:

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

Mengkonversi Word Tabel menjadi Markdown

Word tabel dikonversi secara otomatis saat Anda menggunakan WordToMD. The converter handles:

• Jaringan standar → GFM tabel pipa
• Lebar kolom → standar (Markdown tidak mengontrol lebar kolom)
• Format teks di dalam sel → dipertahankan (dewasa, kursif, tautan)

Apa yang tidak mengkonversi:

• Sel yang digabungkan (colspan/rowspan) runtuh ke sel terdekat
• Isi sel multi-garis putus garis terhapus
• Meja tertanam Meja dalam rata

Mengatasi Komplek Word Tabel

Sel-sel yang Digabungkan

Words sel yang digabungkan tidak memiliki Markdown setara. Pilihan:

1. Restrukturisasi Pembagian baris yang digabungkan menjadi tabel terpisah
2. Gunakan HTML Sebagian besar prosesor Markdown menerima sintaksis tabel HTML:

<table>
  <tr>
    <th colspan="2">Merged Header</th>
  </tr>
  <tr>
    <td>Cell 1</td>
    <td>Cell 2</td>
  </tr>
</table>

Konten sel multi-baris

Penggunaan <br> untuk putus garis di dalam sel (bekerja pada GitHub dan sebagian besar platform):

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

Meja Besar

Untuk tabel dengan banyak kolom, pertimbangkan apakah tabel adalah format yang tepat. Alternatif:

• Daftar definisi (istilah + deskripsi)
• Beberapa tabel kecil menurut kategori
• Sebuah blok kode untuk data terstruktur (JSON, YAML)

Rendering tabel menurut platform

Aksesibilitas

Untuk aksesibilitas yang lebih baik, pastikan tabel memiliki baris header dengan nama kolom yang bermakna. Pembaca layar menggunakan baris header untuk mengumumkan konteks sel.

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

Hindari menggunakan tabel untuk tujuan tata letak gunakan mereka hanya untuk data tabel yang sebenarnya.

FAQ

Mengapa tabel rendering saya tidak ditampilkan sebagai teks kosong? Baris pemisah ( |---|---| baris) adalah wajib. Tanpa itu, parser tidak akan mengenali struktur tabel.

Bisakah aku mendapatkan meja tanpa baris header? Tidak dalam standar GFM. Baris header dan separator diperlukan. Jika Anda tidak ingin heder yang terlihat, gunakan heder kosong: | | | dengan baris pemisah.

Mengapa tabel saya dari Word terlihat benar di WordToMD tetapi salah setelah saya menempelkannya di tempat lain? Masalahnya biasanya adalah ruang putih di sel atau karakter pipa yang tidak konsisten. Sebagian besar Markdown renderer lembut, tetapi copy-paste dapat memperkenalkan karakter yang tidak terlihat.

Bagaimana saya membuat tabel secara programatis dari data? Perpustakaan seperti markdown-table (npm) atau Pythons tabulate dapat menghasilkan tabel Markdown dari array. Ini berguna untuk batch-converting CSV atau data database.

Panduan terkait

• Apa itu Markdown? Markdown dasar-dasar
• Markdown Sintaksis panduan ringkas Referensi sintaksis lengkap
• Cara Mengonversi Word ke Markdown Panduan konversi lengkap
• DOCX ke Markdown dengan Tabel Berfokus pada konversi tabel

Kesimpulan

Tabel Markdown sangat kuat untuk menampilkan data terstruktur dan didukung secara luas di semua platform utama. Untuk tabel yang dimulai dengan Word, WordToMD mengubahnya secara otomatis ke sintaksis GFM. Untuk tata letak yang kompleks, backup HTML dan trik di atas memberi Anda kontrol yang Anda butuhkan.