Generator Tabel Markdown

Apa sebenarnya tabel Markdown itu

Tabel Markdown bukan bagian dari spesifikasi Markdown yang asli; tabel ini berasal dari GitHub Flavored Markdown, dialek yang dipopulerkan oleh GitHub dan kini didukung hampir di mana pun para pengembang menulis. Sintaksnya sengaja dibuat berupa teks biasa: kolom dipisahkan oleh karakter pipa, baris header berada di atas, dan baris kedua berupa tanda hubung memisahkan header dari badan tabel. Karena ia hanya teks, sebuah tabel Markdown tetap mudah dibaca dalam bentuk mentahnya dan bertahan melalui salin-tempel, diff kontrol versi, dan email dengan cara yang tidak mungkin dilakukan oleh tabel HTML.

Alat ini menghilangkan kerepotan menyejajarkan pipa-pipa tersebut. Anda menempelkan baris-baris biasa, alat menentukan kolom-kolomnya, dan menuliskan tabel yang terbentuk dengan benar lengkap dengan header, baris pembatas, dan setiap sel pada tempatnya.

Anatomi sintaksnya

Sebuah tabel minimal tampak seperti tiga baris. Baris pertama mendaftarkan header yang dipisahkan oleh pipa, misalnya Name lalu sebuah pipa lalu Role. Baris kedua adalah pemisah: satu kelompok tanda hubung per kolom, seperti tiga tanda hubung, sebuah pipa, tiga tanda hubung. Setiap baris setelah itu adalah baris data yang menggunakan pola pipa yang sama. Pipa terluar di awal dan akhir setiap baris bersifat opsional di GFM, tetapi menyertakannya membuat teks mentah lebih mudah dibaca dan itulah yang dihasilkan generator ini.

Baris pemisah memiliki fungsi ganda: ia sekaligus menandakan bahwa baris di atasnya adalah header dan, melalui penempatan titik dua, mendeklarasikan bagaimana setiap kolom diratakan. Itulah sebabnya tabel Markdown selalu memerlukan setidaknya satu baris header dan satu baris pemisah agar dapat ditampilkan sama sekali.

Mengatur perataan kolom

Perataan sepenuhnya berada pada tanda hubung di baris pemisah, dikendalikan oleh titik dua. Titik dua di sebelah kiri tanda hubung meratakan kolom ke kiri, titik dua di kedua sisi menengahkannya, dan titik dua di sebelah kanan meratakannya ke kanan. Jadi kolom yang ditengahkan ditulis sebagai titik dua, beberapa tanda hubung, lalu titik dua, sedangkan kolom yang diratakan ke kanan diakhiri dengan titik dua. Perataan ke kanan adalah pilihan konvensional untuk kolom numerik agar digit-digitnya sejajar berdasarkan nilai tempat.

Memilih Kiri, Tengah, atau Kanan pada alat ini menuliskan penanda titik dua tersebut untuk Anda di seluruh tabel, yang berarti perataannya ditampilkan secara identik di GitHub, di generator dokumentasi, dan di penampil GFM lainnya alih-alih bergantung pada pengaturan pembaca.

Sebuah contoh nyata

Tempelkan tiga baris yang dipisahkan koma, Name, Role, City di atas diikuti oleh Ada Lovelace, Engineer, London dan Grace Hopper, Admiral, New York. Dengan perataan tengah dipilih, alat memancarkan satu baris header berisi tiga judul tersebut, satu baris pemisah di mana tanda hubung setiap kolom dibungkus titik dua, dan dua baris data. Ditempelkan ke dalam README di GitHub, ia ditampilkan sebagai tabel tiga kolom yang rapi dengan nilai-nilai yang ditengahkan, tanpa perlu menghitung pipa secara manual.

Meng-escape pipa dan jebakan lainnya

Pipa adalah pemisah kolom, sehingga sebuah pipa harfiah di dalam sebuah sel biasanya akan memecah sel itu menjadi dua dan merusak tabel. Alat ini meng-escape setiap pipa pada data Anda secara otomatis dengan menuliskannya sebagai garis miring terbalik diikuti pipa, sehingga sebuah nilai seperti ekspresi logika yang mengandung simbol OR tetap berada dalam satu sel dan ditampilkan sesuai maksudnya.

Ada dua hal lain yang perlu diketahui. Tabel Markdown tidak dapat memuat jeda baris keras di dalam sebuah sel menggunakan tombol Enter; jika Anda membutuhkan jeda di dalam sebuah sel, Anda akan menyisipkan tag br eksplisit, karena GFM mengizinkan HTML inline. Dan setiap baris seharusnya memiliki jumlah kolom yang sama dengan header. Sel berlebih pada sebuah baris diabaikan oleh sebagian besar perender dan sel yang hilang ditampilkan kosong, jadi jagalah baris-baris Anda tetap persegi panjang demi hasil yang dapat diprediksi.

Pemisah dan nilai bertanda kutip

Data nyata tidak selalu datang dipisahkan koma. Membiarkan pemisah pada Otomatis memungkinkan alat mendeteksi apakah baris-baris Anda memakai koma, tab, atau pipa, yang berarti blok yang disalin langsung dari spreadsheet (dipisahkan tab) maupun ekspor CSV (dipisahkan koma) sama-sama terkonversi tanpa konfigurasi. Anda juga dapat memaksa pemisah tertentu ketika deteksi otomatis akan menebak salah, seperti pada data yang secara sah memuat banyak koma.

Nilai CSV bertanda kutip juga ditangani dengan benar. Koma di dalam tanda kutip ganda diperlakukan sebagai bagian dari nilai, sehingga sebuah field seperti entri nama-belakang-dulu yang bertanda kutip tetap berada dalam satu sel alih-alih pecah menjadi dua kolom. Hal ini penting karena ekspor spreadsheet secara rutin memberi tanda kutip pada nilai apa pun yang dengan sendirinya memuat pembatas.

Di mana tabel Markdown berfungsi, dan di mana tidak

Tabel Markdown bersinar dalam konteks pengembang dan penulisan: README, issue, dan pull request di GitHub dan GitLab; generator situs statis dan dokumentasi; banyak wiki dan aplikasi catatan; alat obrolan seperti Slack dan Discord pada field yang sadar-Markdown; serta komentar Reddit. Di mana pun GFM didukung, tabel yang ditempel langsung berfungsi dan tetap terbaca dalam bentuk sumbernya.

Namun tabel ini tidak universal. Markdown biasa tanpa ekstensi GFM tidak memahami tabel, dan beberapa perender ringan mengabaikannya, dalam hal ini pipa-pipa mentahnya akan tampak menonjol. Tabel Markdown juga tidak memiliki kontrol penataan yang halus, sel yang digabung, dan struktur bersarang. Ketika Anda membutuhkan pemformatan yang presisi, colspan, atau penataan yang kaya, tabel HTML adalah pilihan yang lebih baik; ketika Anda menginginkan tabel yang bersih, dapat dikontrol-versi, dan mudah dibaca manusia, Markdown yang menang.