AI di perangkat — profesional dan privat.

Dokumen

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

1

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.

2

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.

3

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.

4

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.

5

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:

PerataanPemisah yang ditulisCocok 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 Markdown

Tanda 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 selMasalah jika tidak di-escapeYang dilakukan konverter
Tanda pipa |Sel berakhir terlalu cepat; baris mendapat kolom tambahan dan data bergeserSelalu di-escape menjadi \|
Garis miring terbalikBisa menelan karakter sesudahnyaSelalu digandakan, sehingga path Windows tetap utuh
Pergantian baris di kolom yang diapit tanda kutipBaris berakhir di tengah sel dan sisa tabel berantakanMenjadi <br> secara bawaan, atau \n harfiah, atau spasi
Tanda bintang, garis bawah, backtickTeks menjadi tebal, miring, atau kodeDi-escape hanya jika Escape karakter Markdown menyala
Kurung siku, kurung sudut, tildeBisa menjadi tautan, HTML, atau coretanDi-escape dengan sakelar yang sama
Tanda hubung, titik, tanda plusTidak ada masalah di dalam sel tabelDibiarkan 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:

TujuanBatas praktisYang perlu dilakukan
Issue, pull request, atau komentar di GitHubIsi teksnya dibatasi 65.536 karakterGunakan Batasi baris, atau simpan tabel sebagai berkas .md di repositori
README atau berkas dokumentasi di repositoriTidak ada batas kecil, tetapi tabel yang sangat panjang sulit dibacaTampilkan contoh dan tautkan CSV lengkapnya
Halaman apa pun yang dibaca di ponselTabel yang lebar harus digeser ke sampingBatasi sekitar 4 sampai 6 kolom
Teks mentah di editorPengisian spasi membuat setiap baris selebar nilai terpanjangGunakan 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.

Baca juga

Lainnya tentang Dokumen →