CSV ke Tabel Markdown: Cara Mengonversi CSV untuk GitHub, README, dan Dokumentasi
Ubah CSV menjadi tabel Markdown untuk GitHub, README, atau dokumentasi: perataan per kolom, tanda pipa dan pergantian baris yang aman, serta batas ukuran.
Diperbarui 8 November 2026Baca 8 menit
Untuk mengubah CSV menjadi tabel Markdown, letakkan berkasnya di konverter CSV ke Markdown, periksa pratinjau yang sudah terender, atur perataan setiap kolom, lalu salin hasilnya ke README, issue, atau halaman dokumentasi Anda. Konverter menulis tiga bagian yang dibutuhkan setiap tabel Markdown: baris header, baris pemisah berisi tanda hubung, dan satu baris per data. Bagian sulitnya bukan bentuk tabel, melainkan isi selnya: tanda pipa, pergantian baris di dalam kolom yang diapit tanda kutip, atau tanda bintang yang tersesat bisa memecah baris, menggeser data ke kolom yang salah, atau membuat teks menjadi miring. Panduan ini membahas langkah-langkahnya, perataan, karakter-karakter bermasalah itu, dan batas ukuran yang perlu diketahui sebelum menempel.
Cara mengonversi CSV menjadi tabel Markdown
Tambahkan CSV
Buka konverter CSV ke Markdown dan letakkan berkas .csv, .tsv, .txt, atau .psv. Pemisah, karakter kutip, dan pengkodean dideteksi dari berkas itu sendiri, dan alat ini memberi tahu apa yang dipilihnya.
Periksa baris header
Biarkan Baris pertama sebagai header menyala jika baris pertama berisi nama kolom. Matikan jika berkas langsung dimulai dengan data; tabel lalu mendapat label otomatis Col 1, Col 2.
Atur perataan
Pilih Perataan bawaan untuk seluruh tabel, lalu ubah kolom tertentu lewat menu tarik-turun di header kolom tersebut pada pratinjau. Angka biasanya paling mudah dibaca jika rata kanan.
Periksa pratinjau dalam dua tampilan
Beralih antara Terender dan Markdown. Tampilan terender menunjukkan apakah sel yang berisi tanda bintang atau pergantian baris tampil dengan benar; tampilan mentah menunjukkan persis apa yang akan Anda tempel.
Salin atau unduh
Tekan Konversi ke Markdown, lalu Salin Markdown untuk README atau pull request, atau Unduh .md dengan nama berkas yang Anda ketik di Unduh sebagai.
Bagian-bagian sebuah tabel Markdown
Tabel Markdown dalam dialek GitHub-Flavored adalah teks biasa. Baris pertama adalah header, dengan sel-sel yang dipisahkan tanda pipa. Baris kedua adalah pemisah: tanda hubung di bawah setiap kolom, dan keberadaannya itulah yang membuat blok tersebut menjadi tabel. Setiap baris berikutnya adalah satu data. GitHub, GitLab, Obsidian, VS Code, dan sebagian besar generator situs statis membaca format yang sama, jadi satu tabel hasil konversi bisa dipakai di semuanya.
Format ini punya batasan tegas yang perlu diketahui sejak awal. Sel tidak bisa digabung lintas baris atau kolom, setiap baris tabel harus muat dalam satu baris teks, dan header selalu ditampilkan tebal. Jika sebuah baris CSV punya sel lebih sedikit daripada header, konverter melengkapinya dengan sel kosong; jika lebih banyak, tabel dilebarkan mengikuti baris terlebar, sehingga tidak ada data yang terpotong diam-diam.
Perataan kolom pada tabel Markdown
Perataan hanya ada di baris pemisah, berupa titik dua di samping tanda hubung. Konverter menuliskannya untuk Anda, dan bisa menulis perataan yang berbeda untuk setiap kolom:
| Perataan | Pemisah yang ditulis | Cocok untuk |
|---|---|---|
| Kiri | :--- | Nama, label, teks bebas |
| Tengah | :---: | Kolom status pendek, ya/tidak, tanda satu karakter |
| Kanan | ---: | Harga, jumlah, persentase |
| Tanpa | --- | Diserahkan ke perender (rata kiri hampir di mana-mana) |
Kasus yang paling umum adalah tabel yang mencampur nama produk dengan harga dan jumlah stok: atur perataan bawaan ke Kiri, lalu ubah dua kolom angka menjadi Kanan di header pratinjaunya. Angka yang rata kanan sejajar pada digit terakhirnya, dan itulah yang membuat pembaca bisa membandingkan satu kolom angka sekilas. Perlu diingat, beberapa aplikasi mengabaikan titik dua; Notion, misalnya, mengubah tabel Markdown yang ditempel menjadi tabelnya sendiri dan membuang perataannya.
Perataan per kolom, escape yang aman untuk tanda pipa dan pergantian baris, keluaran rapi atau ringkas, salin atau unduh .md. Gratis: satu CSV hingga 25 MB, tanpa batas jumlah baris, dengan semua opsi format. Pro: hingga 50 berkas sekaligus dalam satu ZIP atau satu dokumen gabungan. Semuanya diproses di perangkat Anda, bukan di server kami.
Konversi CSV ke MarkdownTanda pipa, pergantian baris, dan karakter yang merusak tabel
Teks dari spreadsheet tidak tahu bahwa ia akan menjadi Markdown. Inilah karakter-karakter yang sering menimbulkan masalah, dan apa yang dilakukan konverter terhadap masing-masing:
| Di dalam sel | Masalah jika tidak di-escape | Yang dilakukan konverter |
|---|---|---|
| Tanda pipa | | Sel berakhir terlalu cepat; baris mendapat kolom tambahan dan data bergeser | Selalu di-escape menjadi \| |
| Garis miring terbalik | Bisa menelan karakter sesudahnya | Selalu digandakan, sehingga path Windows tetap utuh |
| Pergantian baris di kolom yang diapit tanda kutip | Baris berakhir di tengah sel dan sisa tabel berantakan | Menjadi <br> secara bawaan, atau \n harfiah, atau spasi |
| Tanda bintang, garis bawah, backtick | Teks menjadi tebal, miring, atau kode | Di-escape hanya jika Escape karakter Markdown menyala |
| Kurung siku, kurung sudut, tilde | Bisa menjadi tautan, HTML, atau coretan | Di-escape dengan sakelar yang sama |
| Tanda hubung, titik, tanda plus | Tidak ada masalah di dalam sel tabel | Dibiarkan apa adanya, agar tanggal dan harga tetap mudah dibaca |
Pengaturan untuk pergantian baris bernama Pergantian baris dalam sel. Pertahankan <br> untuk GitHub dan GitLab, karena di sana ia tampil sebagai baris baru sungguhan dan alamat surat tetap menjadi satu sel yang mudah dibaca. Pilih \n harfiah jika tabel dikirim ke tempat yang menghapus HTML dan Anda tetap ingin melihat bahwa di situ ada pergantian baris. Pilih Spasi jika pergantian baris itu hanya kebetulan dari proses ekspor, misalnya teks yang terbungkus otomatis di kolom spreadsheet.
Biarkan Escape karakter Markdown mati kecuali pratinjau menunjukkan masalah. Sebagian besar tabel tidak berisi karakter-karakter ini, dan jika sakelar menyala, setiap karakter tersebut mendapat garis miring terbalik yang terlihat di berkas mentah. Sel yang berisi nilai seperti _draf_ atau kata yang diapit tanda bintang adalah kasus ketika Anda memang membutuhkannya: tanpa escape, teks itu tampil miring dan tandanya hilang.
Pastikan CSV terbaca dengan benar lebih dulu
Banyak tabel yang rusak sebenarnya sudah rusak sebelum satu baris Markdown pun ditulis, karena CSV dipecah dengan karakter yang salah. Konverter mencoba koma, titik koma, tab, dan tanda pipa pada sampel, memilih yang menghasilkan lebar baris paling konsisten, dan memberi tahu jika hasil bacaannya meragukan. Ekspor dari Excel dengan pengaturan wilayah Eropa sering memakai titik koma; jika pratinjau menampilkan semuanya dalam satu kolom, atur Pemisah secara manual.
- Pengkodean: jika nama yang memakai huruf beraksen tampil sebagai karakter acak, kemungkinan berkasnya Windows-1252, bukan UTF-8. Atur secara manual; berkas yang membawa byte-order mark (BOM) selalu diutamakan, dan tanda tak terlihat yang ditambahkan ekspor CSV UTF-8 dari Excel dihapus agar tidak menempel di judul kolom pertama Anda.
- Lewati baris awal: ekspor laporan sering memuat judul dan tanggal di atas header yang sebenarnya. Lewati baris-baris itu agar baris pertama menjadi header.
- Buang baris kosong dan Buang kolom kosong: ekspor spreadsheet sering menumpuk baris kosong di bagian bawah dan kolom tak terpakai di samping. Masing-masing akan menjadi sel kosong di tabel Anda.
- Batasi baris: README cukup memuat 20 baris pertama dari ekspor yang besar, bukan semuanya. Nilai 0 mempertahankan semua baris.
Jika tabel membutuhkan lebih sedikit kolom daripada CSV-nya, buang kolom itu lebih dulu dengan Tambah atau Hapus Kolom CSV, dan baca cara menghapus kolom dari CSV untuk detailnya. Tabel dengan empat kolom yang dipilih dengan cermat jauh lebih mudah dibaca daripada tabel dengan dua belas kolom.
Batas ukuran: konverter dan tempat Anda menempel
Pada versi gratis, konverter menerima satu berkas hingga 25 MB, tanpa batas jumlah baris. Situs ini mengukur bahwa ekspor 25 MB berisi sekitar 225.000 baris selesai dikonversi dalam kira-kira satu detik di komputer desktop. Pratinjau hanya menampilkan baris dan kolom pertama agar halaman tetap ringan, tetapi berkas unduhan dan teks yang disalin memuat semuanya. Pro mengonversi hingga 50 berkas sekaligus, baik dalam satu ZIP maupun digabung menjadi satu dokumen Markdown dengan setiap tabel di bawah judul yang diambil dari nama berkasnya.
Batas yang lebih ketat biasanya datang dari tujuan, bukan dari konverter:
| Tujuan | Batas praktis | Yang perlu dilakukan |
|---|---|---|
| Issue, pull request, atau komentar di GitHub | Isi teksnya dibatasi 65.536 karakter | Gunakan Batasi baris, atau simpan tabel sebagai berkas .md di repositori |
| README atau berkas dokumentasi di repositori | Tidak ada batas kecil, tetapi tabel yang sangat panjang sulit dibaca | Tampilkan contoh dan tautkan CSV lengkapnya |
| Halaman apa pun yang dibaca di ponsel | Tabel yang lebar harus digeser ke samping | Batasi sekitar 4 sampai 6 kolom |
| Teks mentah di editor | Pengisian spasi membuat setiap baris selebar nilai terpanjang | Gunakan keluaran ringkas untuk sel berisi teks panjang |
Ingat bahwa Markdown lebih besar daripada CSV asalnya: setiap sel mendapat tanda pipa dan spasi, dan pengisian spasi menambah lebih banyak lagi. Ekspor lengkap jarang cocok dimasukkan ke dokumen. Dua puluh baris yang dipilih dengan baik beserta tautan ke berkas sumbernya adalah yang diinginkan sebagian besar pembaca.
Opsi lain yang perlu diketahui
- Nomori barisnya menambahkan kolom nomor urut, berguna saat peninjau perlu menulis "baris 14 salah" di komentar.
- Baris data pertama tebal dan Kolom pertama tebal hanya berlaku untuk isi tabel, karena header sudah tampil tebal.
- Tanda kutip bisa diatur ke kutip ganda, apostrof, atau tanpa kutip; tanda kutip hanya membuka kolom jika berada di awal nilai, sehingga apostrof pada O'Brien tetap menjadi teks.
Kapan tabel Markdown bukan pilihan yang tepat
Tabel Markdown cocok untuk data kecil yang enak dibaca di dalam teks. Jika seseorang perlu mengurutkan, memfilter, atau menghitung, berikan datanya sebagai spreadsheet dengan CSV ke Excel. Jika data akan dibaca oleh program, CSV ke JSON adalah format yang lebih baik. Jika Anda hanya perlu melihat-lihat berkas besar sebelum memilih baris, buka dulu di Penampil CSV.
Jika tabel Anda berasal dari dokumen Word, bukan CSV, pekerjaannya berbeda: judul, daftar, dan format ikut terbawa. Hal itu dibahas di mengonversi Word ke Markdown, menggunakan alat Word ke Markdown.
Pertanyaan umum
Bagaimana cara mengonversi CSV menjadi tabel Markdown?
Letakkan CSV di konverter CSV ke Markdown, biarkan Baris pertama sebagai header menyala jika baris pertama berisi nama kolom, atur perataan, lalu tekan Konversi ke Markdown dan salin hasilnya atau unduh sebagai berkas .md. Baris header, baris pemisah, dan escape ditulis otomatis untuk Anda.
Bagaimana cara membuat kolom rata kanan di tabel Markdown?
Letakkan titik dua di ujung kanan pemisah kolom tersebut, ditulis ---:. Di konverter, Anda mengaturnya lewat menu tarik-turun di header kolom pada pratinjau, sehingga kolom angka bisa rata kanan sementara teks tetap rata kiri.
Bagaimana cara memasukkan tanda pipa ke dalam sel tabel Markdown?
Escape menjadi \| agar tidak dibaca sebagai akhir sel. Konverter melakukannya otomatis untuk setiap tanda pipa, termasuk yang berada di dalam teks yang tampak seperti kode.
Bisakah sel tabel Markdown berisi pergantian baris?
Tidak secara langsung: setiap baris tabel harus berupa satu baris teks. Di GitHub dan GitLab, <br> di dalam sel tampil sebagai baris baru, dan itulah bawaan konverter untuk kolom CSV yang berisi beberapa baris. Anda juga bisa memilih \n harfiah atau satu spasi.
Mengapa seluruh CSV saya tampil dalam satu kolom?
Berkas memakai pemisah yang berbeda dari yang diterapkan, paling sering titik koma pada ekspor dari Excel dengan pengaturan wilayah Eropa. Atur Pemisah secara manual ke Titik koma, Tab, atau Pipe, dan kolom-kolomnya akan terpisah.
Apakah ada batas ukuran untuk mengonversi CSV ke Markdown?
Versi gratis mengonversi satu berkas hingga 25 MB tanpa batas jumlah baris dan dengan semua opsi format. Pro menangani hingga 50 berkas sekaligus. Batas yang lebih sering ditemui adalah tujuannya: GitHub membatasi isi issue atau pull request hingga 65.536 karakter, jadi gunakan Batasi baris untuk tabel yang ditempel di sana.