Markdown Tabel Generator

Bangun tabel Markdown secara visual dengan editor seperti spreadsheet.

Tidak ada data yang meninggalkan perangkat Anda
3 × 3

Klik L / C / R di bawah setiap header kolom untuk mengatur perataan (kiri, tengah, kanan).

Keluaran Markdown

Tentang tabel Markdown

Tabel Markdown menggunakan bilah vertikal (|) dan tanda hubung (-) untuk membuat data tabular terstruktur dalam teks polos. Mereka didukung oleh GitHub, GitLab, Reddit, dan sebagian besar penghasil Markdown. Baris perataan menggunakan titik dua untuk menunjukkan perataan kiri, tengah, atau kanan untuk setiap kolom.

Menulis tabel Markdown secara manual bisa membosankan dan rentan kesalahan. Editor visual ini memungkinkan Anda memasukkan data dalam grid seperti spreadsheet dan menghasilkan Markdown yang diformat dengan benar secara real-time. Semua pemrosesan dilakukan di browser Anda.

Sintaks Tabel Pipe, Secara Mekanis

Sebuah tabel GFM terdiri dari tiga bagian: baris header dengan sel-sel dipisahkan oleh pipe (|), baris pembatas tepat di bawah menggunakan tanda hubung (---) untuk setiap kolom, dan nol atau lebih baris data dengan struktur dipisahkan pipe yang sama. Pipe di awal dan akhir setiap baris bersifat opsional tetapi secara konvensional disertakan untuk keterbacaan. Penjajaran kolom ditentukan oleh titik dua di baris pembatas: :--- untuk rata kiri (default), :---: untuk tengah, ---: untuk rata kanan. Tabel minimum yang dapat berfungsi terlihat seperti ini di sumber: | Header | Header | di baris 1, | --- | --- | di baris 2, | Sel | Sel | dari baris 3 dan seterusnya. Konten sel dapat menyertakan format Markdown inline apa pun (bold, italic, link, code span, gambar) tetapi tidak dapat menyertakan elemen tingkat block (daftar, blok kode, blockquote). Pemutusan baris dalam sel perlu dikodekan sebagai tag <br> daripada newline literal, karena newline literal akan merusak struktur tabel. Karakter pipe di dalam konten sel harus di-escape sebagai \|, jika tidak parser akan memperlakukannya sebagai pemisah kolom dan jumlah kolom baris menjadi salah. Sebagian besar parser mentoleransi lebar kolom yang tidak rata; sumber | a | b | dan | aaa | b | dirender secara identik, meskipun yang kedua terlihat lebih "benar" di sumber. Alat ini selalu mengeluarkan sumber dengan lebar yang rata untuk keterbacaan, tetapi dirender sama dengan sumber yang kompak.

Di Mana Tabel Dirender dan di Mana Tidak

Dirender dengan benar: GitHub (issue, pull request, README, halaman wiki, diskusi, code review, komentar di mana saja), GitLab (permukaan yang sama), Bitbucket, Stack Overflow, Reddit (ketika GFM diaktifkan di subreddit, yang merupakan kebanyakan dari mereka), Discord (hanya dalam konteks blok kode, tabel GFM lengkap tidak dirender dalam pesan chat tetapi markdown-it memprosesnya di permukaan dokumen), Notion (dengan impor tabelnya sendiri), Obsidian, Logseq, Bear, sebagian besar generator situs statis (Hugo, Jekyll, Eleventy, Astro dengan plugin remark-gfm, Next.js MDX), preview VS Code, GitHub Pages, Read the Docs (tergantung konfigurasi). Tidak dirender dengan benar: CommonMark ketat (Pandoc dengan reader commonmark dan tanpa ekstensi, parser Discount C tanpa flag pipe-table), Slack (merender subset Markdown tetapi bukan tabel), sebagian besar klien email (HTML yang dirender dalam email secara struktural baik-baik saja tetapi diberi gaya inline, bukan Markdown), instalasi WordPress yang lebih lama tanpa plugin Markdown. Aturan umum: jika tujuan Anda adalah platform yang berorientasi developer (keluarga GitHub, dokumentasi teknis), tabel GFM bekerja. Jika tujuan Anda adalah platform untuk audiens umum (Slack, email, Twitter), asumsikan tabel tidak akan dirender dan baik pra-rendernya menjadi gambar atau tulis ulang sebagai daftar.

Sintaks Tabel Markdown Alternatif

Format tabel pipe mendominasi karena jangkauan GitHub, tetapi itu bukan satu-satunya sintaks tabel Markdown. Tabel sederhana Pandoc menggunakan pemisah baris kosong-dan-tanda hubung dan menjajarkan kolom berdasarkan posisi visual daripada pipe, jauh lebih mudah dibaca untuk tabel sempit tetapi lebih sulit ditulis dengan tangan. Tabel multi-baris Pandoc mendukung sel yang melintang beberapa baris, penting untuk konten deskriptif panjang yang tidak muat dalam satu baris. Tabel grid Pandoc menggunakan batas seni ASCII (+---+---+) yang tampak menyakitkan untuk dipelihara dengan tangan tetapi mudah dikeluarkan oleh alat. reStructuredText (Sphinx) menggunakan tabel grid secara eksklusif, setiap dokumentasi proyek Python ditulis dengan cara ini. AsciiDoc menggunakan sintaks awalan pipe yang berbeda (|===) yang dioptimalkan untuk penulisan buku teknis. HTML dalam Markdown selalu tersedia sebagai jalan keluar: prosesor Markdown apa pun melewatkan HTML mentah, jadi ketika tabel pipe tidak cukup Anda dapat memasukkan <table> sungguhan dengan rentang baris/kolom penuh, markup semantik, dan styling CSS. Sintaks tabel pipe yang dihasilkan alat ini adalah gaya GFM, pilihan paling kompatibel untuk ekosistem developer modern.

Penggunaan umum

Masalah Lebar dan Batasan Lainnya

Tabel pipe memiliki beberapa batasan inheren yang perlu diketahui. Lebar kolom dibatasi oleh konten sel terpanjang, URL panjang atau paragraf deskriptif dalam satu sel memaksa seluruh kolom menjadi lebar, yang dapat menghasilkan tabel yang sulit dikelola yang tidak muat dalam lebar halaman dokumentasi standar. Perbaikannya adalah memotong konten panjang (menautkan ke tempat lain untuk detail) atau menggunakan HTML inline jika Anda memerlukan sel yang dapat dibungkus. Tidak ada rentang baris atau kolom, setiap sel menempati tepat satu baris dan satu kolom. Tabel kompleks dengan sel yang digabungkan memerlukan HTML <table> sungguhan dengan atribut rowspan / colspan. Tidak ada tabel bersarang, Anda tidak dapat menempatkan tabel di dalam sel tabel lain di Markdown. Tidak ada konten tingkat block dalam sel, tidak ada daftar, tidak ada blok kode, tidak ada blockquote di dalam sel. Konten inline (bold, italic, code span, link, gambar) baik-baik saja tetapi apa pun yang multi-baris memerlukan tag <br>. Baris header wajib di GFM, tidak ada sintaks tabel tanpa header. Jika Anda ingin tabel tanpa header yang terlihat, biarkan sel header kosong tetapi baris masih harus ada. Penjajaran berlaku per kolom ke seluruh kolom, Anda tidak dapat memiliki penjajaran berbeda untuk sel berbeda di kolom yang sama. Untuk layout tabel canggih yang melampaui batasan ini, alat yang tepat adalah HTML di sumber Markdown Anda, bukan Markdown itu sendiri.

Konversi CSV ↔ Markdown

Sebagian besar data tabular dunia nyata hidup dalam file CSV (ekspor spreadsheet, respons API, output analisis log), mengonversi ke dan dari Markdown adalah alur kerja umum. CSV → Markdown: parse CSV (menangani field yang dikutip dengan koma yang disematkan, kutipan yang di-escape, pemutusan baris dalam field), kemudian format setiap baris sebagai | nilai | nilai | dengan baris header dan pembatas yang sesuai. Sebagian besar generator tabel termasuk yang ini menawarkan impor CSV; untuk konversi sekali pakai Anda juga dapat menggunakan alat command-line csvlook dari csvkit yang menghasilkan output format pipe yang serupa. Markdown → CSV: parse tabel GFM kembali menjadi baris dan kolom, kemudian keluarkan CSV dengan kutipan yang tepat. Berguna saat mengekstrak data terstruktur dari dokumentasi kembali ke bentuk spreadsheet untuk analisis. Arah Markdown-ke-CSV ditawarkan oleh alat seperti pandoc (dengan kombinasi reader/writer yang tepat), tableconvert.com, dan berbagai utilitas command-line. Round-tripnya lossy dalam satu arah, pemformatan (bold, link, gambar) bertahan melalui langkah CSV utuh hanya jika Anda menulis konten sel CSV sebagai teks Markdown mentah dan memperlakukan hasilnya sebagai Markdown lagi.

Privasi: Mengapa Browser-Saja Penting Bahkan di Sini

Tabel tampaknya bukan data sensitif, tetapi isi tabel sering kali demikian. Rencana proyek berisi keputusan personel dan fitur yang belum diumumkan. Tabel harga berisi informasi komersial. Tabel perbandingan dalam posting blog yang belum dipublikasikan mengungkapkan positioning editorial. Item tindakan catatan rapat berisi informasi penugasan dan akuntabilitas. Generator tabel sisi server mengunggah data Anda ke pihak ketiga di mana ia berada di log. Alat ini berjalan sepenuhnya di browser Anda melalui JavaScript, verifikasi di tab Network DevTools saat Anda mengedit sel, atau bawa halaman offline (mode pesawat) setelah dimuat dan editor masih bekerja. Aman untuk draft dokumentasi yang belum dipublikasikan, perencanaan proyek internal, tabel perbandingan untuk posting blog yang belum dipublikasikan, atau konten tabel apa pun yang tidak ingin Anda salin ke hard drive orang asing.

Pertanyaan umum

Sintaks tabel Markdown apa yang dihasilkan?

Ia menghasilkan sintaks GFM (GitHub Flavored Markdown) standar dengan bilah vertikal, baris pemisah dengan tanda hubung, dan titik dua opsional untuk perataan. Sintaks ini berfungsi di GitHub, GitLab, Reddit, Jekyll, Hugo, dan sebagian besar prosesor Markdown.

Bagaimana cara mengatur perataan kolom?

Klik tombol L (kiri), C (tengah), atau R (kanan) di bawah setiap header kolom. Perataan kiri menggunakan :---, tengah :---:, dan kanan ---: di baris pemisah.

Bisakah saya impor dari CSV atau menempel dari spreadsheet?

Impor CSV ada di roadmap. Untuk saat ini, menempel-dari-Excel/Google Sheets sering bekerja karena sebagian besar aplikasi spreadsheet meletakkan data yang dipisahkan tab di clipboard, yang dapat Anda tempel ke sel individual. Untuk impor CSV massal tanpa tempel manual, alat command-line seperti csvlook dari csvkit menghasilkan output tabel GFM yang serupa, atau pandoc dapat mengonversi CSV ke Markdown langsung dengan pandoc --from csv --to gfm input.csv.

Bagaimana dengan sel yang digabungkan, tabel bersarang, atau konten block dalam sel?

Tabel pipe GFM tidak mendukung ini. Setiap sel menempati tepat satu baris dan satu kolom; tidak ada rowspan atau colspan. Tidak ada tabel bersarang. Tidak ada konten tingkat block (daftar, blok kode, blockquote) di dalam sel, hanya konten inline (bold, italic, code span, link, gambar, pemutusan baris melalui <br>). Untuk layout tabel canggih yang melampaui batasan ini, sematkan HTML <table> mentah langsung di sumber Markdown Anda, setiap prosesor Markdown melewatkan HTML tanpa perubahan. Trade-offnya adalah sumber menjadi jauh lebih sulit dibaca dan diedit dengan tangan.

Apakah ada batas jumlah baris atau kolom?

Anda dapat memiliki hingga 20 kolom dan 100 baris. Untuk sebagian besar dokumentasi dan file README, ini lebih dari cukup. Tabel diperbarui secara real-time saat Anda mengetik.

Apakah isi tabel saya dikirim ke mana pun?

Tidak. Generasi berjalan sepenuhnya di browser Anda melalui JavaScript. Sel yang Anda edit dan output Markdown tidak pernah melintasi jaringan, verifikasi di tab Network DevTools saat Anda mengetik, atau bawa halaman offline (mode pesawat) setelah dimuat dan editor masih bekerja. Aman untuk draft dokumentasi yang belum dipublikasikan, rencana proyek internal, tabel perbandingan harga yang belum dipublikasikan, atau konten tabular apa pun yang tidak ingin Anda salin ke hard drive orang asing.

Alat terkait

Pratinjau Markdown

Tulis Markdown dan pratinjau rendering.

Markdown → HTML

Konversi Markdown ke kode HTML yang bersih.

Generator tabel HTML

Bangun tabel HTML secara visual dan salin kodenya.