Konversi CSV ke Markdown

1. 1

   Jatuhkan CSV

   Seret berkas .csv, .tsv, .txt, atau .psv ke halaman, atau pilih lewat penjelajah. Pemisah, tanda kutip, dan pengkodean dibaca dari berkas itu sendiri, dan alat ini menyebutkan pilihannya.

2. 2

   Periksa pratinjau terender

   Pratinjau menampilkan tabel sebagaimana akan dirender, bukan hanya teks mentah — jadi Anda langsung melihat apakah sel berisi tanda bintang atau pergantian baris akan berperilaku benar.

3. 3

   Atur perataan dan format

   Pilih perataan untuk seluruh tabel atau per kolom dari kepala pratinjau. Nyalakan keluaran rapi untuk teks mentah yang mudah dibaca, escape untuk sel berisi karakter Markdown, baris bernomor, atau baris/kolom pertama tebal.

4. 4

   Salin atau unduh

   Tekan Konversi, lalu Salin untuk menaruh tabel di papan klip untuk README atau pull request, atau unduh sebagai berkas .md dengan nama pilihan Anda. Semuanya berjalan di perangkat Anda.

Konversi CSV menjadi tabel Markdown gaya GitHub, dengan dua hal yang menentukan apakah hasilnya bisa dipakai: escape yang benar, dan kendali atas bagaimana setiap kolom diratakan. Pakai baris pertama sebagai header atau biarkan label kolom dibuat otomatis, atur perataan untuk tabel atau per kolom, rapikan keluaran atau biarkan ringkas, dan lihat tabel terender di samping Markdown mentah sebelum menyalinnya.

• Format tabel Markdown — Markdown gaya GitHub: satu baris header, satu baris pemisah yang membawa perataan, lalu satu baris per catatan. Ia terender di GitHub, GitLab, Obsidian, Notion, VS Code, Jira, dan Confluence tanpa perubahan.
• Perataan per kolom — Tetapkan bawaan untuk tabel, lalu timpa kolom mana pun dari menu di kepala kolomnya pada pratinjau. Kiri, tengah, kanan, atau tanpa.
• Baris pertama sebagai header — Pakai baris pertama CSV sebagai header tabel, atau matikan untuk memperlakukan setiap baris sebagai data dengan label Col 1, Col 2 yang dibuat otomatis.
• Escape yang tahan — Pipe dan backslash selalu di-escape, pergantian baris di dalam sel menjadi <br>, dan tanda bintang, garis bawah, backtick, kurung siku, tanda kurung sudut, serta tilde juga bisa di-escape.
• Rapi atau ringkas — Ratakan setiap kolom agar berkas mentah sejajar di editor teks, atau biarkan ringkas agar tabel yang dibuat ulang menghasilkan diff sekecil mungkin.
• Pratinjau terender dan tampilan mentah — Lihat tabel sebagaimana akan dirender dan Markdown sebagaimana akan ditulis, lalu berpindah di antara keduanya. Setiap pengaturan mengubah setidaknya salah satunya.
• Salin atau unduh — Taruh tabel langsung di papan klip untuk README atau pull request, atau unduh sebagai berkas .md dengan nama pilihan Anda.

Tabel Markdown terdiri dari tiga jenis baris, dan mengetahui mana yang mana menjelaskan setiap opsi di halaman ini. Alat ini menulis ketiganya untuk Anda, tetapi bentuknya layak dipahami karena bentuk itulah yang menentukan di mana sebuah tabel rusak.

Header dan baris pemisah

• Baris header — Satu baris sel di antara pipe. Ia selalu tebal saat dirender, itulah sebabnya menebalkannya lagi tidak berpengaruh dan mengapa opsi tebal pada alat ini berlaku untuk tubuh tabel.
• Baris pemisah — Baris tanda hubung tepat di bawah header. Ia bukan hiasan: kehadirannyalah yang membuat blok itu menjadi tabel, dan titik dua di dalamnya adalah satu-satunya cara menetapkan perataan.
• Baris data — Satu baris per catatan. Baris dengan sel lebih sedikit daripada header akan dilengkapi; baris dengan sel lebih banyak akan dipotong oleh sebagian besar perender, jadi berkas yang tidak rata disamakan ke baris terlebar.

Dua hal yang merusak tabel

• Pipe tanpa escape — Pipe di dalam sel mengakhiri sel itu terlalu awal, sehingga baris bertambah satu kolom dan perender menggeser atau membuang datanya. Alat ini selalu meng-escape setiap pipe — itu bukan opsi karena tidak ada kasus di mana karakter mentahnya adalah yang Anda maksud.
• Pergantian baris di dalam sel — Satu baris tabel Markdown adalah satu baris. Bidang CSV berkutip yang berisi pergantian baris — alamat pos, komentar — akan mengakhiri baris di tengah dan setiap baris sesudahnya jatuh keluar tabel. Lihat bagian pergantian baris di bawah untuk tiga cara alat ini menanganinya.

Perataan tinggal di baris pemisah, berupa titik dua. Alat ini menuliskannya untuk Anda, dan perataan itu boleh berbeda per kolom — yang justru Anda inginkan begitu sebuah tabel mencampur label dengan angka.

• Kiri — :--- — Bawaan, dan tepat untuk nama, label, dan teks bebas. Titik dua di kiri tanda hubung.
• Tengah — :---: — Titik dua di kedua sisi. Berguna untuk kolom status pendek dan tanda satu karakter, di mana penengahan terbaca lebih baik daripada tepi kiri yang tidak rata.
• Kanan — ---: — Titik dua di kanan. Inilah yang penting untuk angka: angka rata kanan sejajar pada titik desimal, sehingga kolom harga atau jumlah bisa dibandingkan sekilas.
• Tanpa — --- — Tanpa titik dua sama sekali. Perender memakai bawaannya sendiri, yaitu kiri pada semua perender yang kami tahu, dan baris pemisah tetap sependek mungkin.
• Per kolom — Setiap kepala kolom di pratinjau punya menunya sendiri. Tetapkan bawaan tabel sekali, lalu ubah dua kolom angka menjadi Kanan — tabel berisi nama dan angka terbaca benar dengan sekitar empat klik.

Teks yang datang dari lembar kerja tidak tahu bahwa ia akan menjadi Markdown, dan beberapa karakter yang biasa saja langsung punya makna begitu itu terjadi. Alat ini memisahkan apa yang selalu diperbaikinya dari apa yang Anda pilih.

Selalu di-escape

• Pipe — Ditulis sebagai \| . Pipe tanpa escape mengakhiri sel, yang menggeser atau membuang data — tidak ada versi dari itu yang diinginkan siapa pun, jadi ia bukan saklar.
• Backslash — Digandakan menjadi \\ , dan dikerjakan lebih dulu agar backslash yang ditambahkan setiap aturan lain tidak ikut tergandakan. Jalur Windows di dalam sel tetap utuh.

Pilihan Anda

• Karakter Markdown — Tanda bintang, garis bawah, backtick, kurung siku, tanda kurung sudut, dan tilde. Sel bertuliskan *catatan* dirender miring dengan tanda bintangnya hilang; setelah di-escape ia terbaca *catatan*. Bawaannya mati, karena kebanyakan tabel tidak memuat satu pun dan backslash-nya terlihat di berkas mentah.
• Pergantian baris: <br> — Bawaan. Pergantian di dalam sel menjadi pergantian baris HTML, yang didukung setiap perender Markdown yang mendukung tabel, sehingga alamat beberapa baris tetap satu sel dan tetap terbaca.
• Pergantian baris: \n — Backslash-n harfiah. Tepat ketika tabel menuju tempat yang membuang HTML, dan ketika penting bahwa ada pergantian tanpa merendernya sebagai pergantian.
• Pergantian baris: spasi — Pergantian menjadi satu spasi. Keluaran terpendek, dan pilihan tepat ketika pergantian itu artefak ekspor, bukan makna.
• Yang tidak di-escape — Tanda hubung, titik, dan tanda tambah dibiarkan. Meng-escape-nya secara teknis sah dan mengubah setiap tanggal menjadi 2026\-01\-01 dan setiap harga menjadi 12\.50, yang tidak dibutuhkan perender mana pun dan tidak diinginkan pembaca mana pun.

Separuh dari yang membuat tabel hasil konversi salah terjadi sebelum satu karakter Markdown pun ditulis. Tiga pengaturan ini menentukan apa sebenarnya barisnya, dan ketiganya dideteksi dari berkas dengan penimpaan di sebelahnya.

• Pemisah — Koma, titik koma, tab, atau pipe, dideteksi dengan menguraikan sampel memakai tiap kandidat dan memilih yang menghasilkan lebar baris paling konsisten. Menghitung pemisah di baris pertama — jalan pintas yang lazim — membaca "a,b,c,d";"e";"f" sebagai berpemisah koma dan memampatkan setiap baris menjadi satu kolom.
• Tanda kutip — Kutip ganda, apostrof, atau tanpa, dideteksi dengan cara yang sama. Tanda kutip hanya membuka bidang di posisi pertama, jadi apostrof pada O'Brien tetap apostrof alih-alih menelan sisa barisnya.
• Pengkodean — Otomatis secara bawaan: byte-order mark menang bila berkas punya satu; jika tidak, bita diuji sebagai UTF-8 yang sah dan jatuh ke Windows-1252. Paksa UTF-8, UTF-16LE, UTF-16BE, Windows-1252, atau ISO-8859-1 bila berkas tidak membawa penanda dan tebakannya meleset.
• ISO-8859-1 bukan Windows-1252 — Platform web memperlakukan yang pertama sebagai label bagi yang kedua, jadi kebanyakan alat menawarkan keduanya dan memberi Anda satu. Di sini ISO-8859-1 benar-benar Latin-1 bita ke titik kode, yang penting untuk berkas di mana 0x80 sampai 0x9F adalah kode kendali, bukan tanda kutip tipografis.
• Byte-order mark — Ekspor CSV UTF-8 milik Excel menulis satu, dan alat yang tidak membuangnya menaruh karakter tak terlihat di depan judul kolom pertama Anda. Di sini ia dibuang, dan bila ia bertentangan dengan pengkodean pilihan Anda, alat ini mengatakannya alih-alih diam-diam menimpanya.

Keduanya menghasilkan tabel terender yang sama. Bedanya adalah rupa berkas mentahnya, dan mana yang Anda mau sepenuhnya bergantung pada siapa yang membacanya seperti itu.

• Rapi — Setiap sel dilengkapi agar pipe-nya sejajar dalam satu kolom. Markdown mentahnya terbaca sebagai tabel di editor teks biasa mana pun, dan itulah yang Anda mau ketika seseorang akan membuka berkas .md alih-alih halaman terender.
• Ringkas — Satu spasi di tiap sisi setiap sel, tidak lebih. Keluarannya lebih kecil dan — lebih berguna — satu nilai yang berubah di satu baris tidak melengkapi ulang semua baris lain, sehingga tabel yang dibuat ulang dan disimpan di git menghasilkan diff satu baris alih-alih diff seluruh berkas.
• Pelengkapan mengikuti perataan — Kolom rata kanan dilengkapi di kiri, kolom tengah di kedua sisi. Jadi teks mentahnya sejajar dengan cara yang sama seperti tabel terendernya nanti, dan itulah gunanya melengkapi.
• Baris bernomor — Menambahkan kolom awal yang menghitung baris tubuh mulai dari satu. Berguna untuk menunjuk sebuah baris dalam komentar tinjauan, dan itu bukan bagian dari data Anda: ia dibuat ulang setiap kali tabelnya dibuat ulang.
• Baris atau kolom pertama tebal — Membungkus baris tubuh pertama, atau kolom pertama setiap baris tubuh, dengan tanda bintang ganda. Baris header sudah tebal saat dirender, jadi opsi ini sengaja berlaku untuk tubuh — menebalkan header lagi akan menjadi kendali yang tidak melakukan apa-apa.

Ekspor 25 MB — sekitar 225.000 baris — terkonversi dalam sekitar satu detik di komputer desktop, di thread latar belakang, sehingga halaman tidak pernah membeku.

Ekspor nyata jarang hanya berupa header dan baris. Empat kendali menangani bagian yang seharusnya tidak menjadi sel tabel.

• Lewati baris awal — Membuang baris dari atas sebelum hal lain apa pun terjadi. Laporan dan ekspor dasbor lazim membawa judul, tanggal, dan baris kosong di atas header yang sesungguhnya; lewati itu dan baris satu menjadi header yang seharusnya.
• Batasi baris — Membatasi berapa banyak baris data yang ditulis. Sebuah README menginginkan dua puluh baris pertama dari ekspor besar, bukan keempat puluh ribunya — dan pratinjau menunjukkan persis apa yang akan dihasilkan.
• Buang baris kosong — Membuang setiap baris yang seluruh selnya kosong. Ekspor lembar kerja mengumpulkan baris seperti ini di bagian bawah, dan masing-masing menjadi satu baris sel kosong di tabel.
• Buang kolom kosong — Membuang setiap kolom yang tidak berisi data. Ketika ada baris header, judulnya sendiri tidak mempertahankan kolom itu — kolom tak terpakai yang punya nama justru kasus yang menjadi alasan kendali ini ada, dan judulnya ikut terbuang.

Satu berkas dikonversi pada paket gratis dengan seluruh kendali format tersedia. Mengonversi banyak sekaligus adalah yang ditambahkan paket Pro, dan ia hadir dalam dua bentuk karena keduanya memang pekerjaan yang berbeda.

• Sekelompok berkas — Antrekan hingga lima puluh CSV, konversi dalam satu tindakan, dan bawa pulang sebagai satu ZIP. Nama berkas kembar dibuat unik di dalam arsip alih-alih saling menimpa.
• Satu dokumen gabungan — Antrean yang sama ditulis ke dalam satu berkas Markdown, tiap tabel di bawah judul yang diambil dari nama berkasnya. Ini bentuk yang Anda mau untuk halaman dokumentasi yang harus menampilkan empat tabel terkait di satu tempat.
• Pengaturan berlaku untuk antrean — Perataan, pelengkapan, escape, dan sisanya berlaku untuk setiap berkas dalam kelompok, sehingga sekumpulan ekspor keluar konsisten. Perataan per kolom tetap per berkas, karena kolomnya berbeda.
• Semuanya tetap berjalan di perangkat Anda — Satu kelompok adalah mesin yang sama dijalankan lebih sering. Tidak ada yang diunggah, antrean dibatasi memori Anda sendiri dan bukan oleh server, dan batas ukuran pada paket Pro adalah apa yang sanggup ditangani perangkat Anda.

Tabel yang ditulis alat ini adalah Markdown gaya GitHub, dialek yang hampir semua pihak sepakati. Beberapa tujuan punya keanehan yang layak diketahui sebelum menempel.

• GitHub dan GitLab — README, isu, deskripsi pull request, dan wiki. Titik dua perataan dihormati, dan <br> di dalam sel dirender sebagai pergantian baris.
• Obsidian dan VS Code — Keduanya merender tabel di pratinjau dan keduanya terus-menerus membaca berkas mentah, dan itulah kasus yang menjadi alasan keluaran rapi ada.
• Notion — Menempel tabel Markdown membuat tabel Notion yang sesungguhnya. Perataan tidak ikut terbawa, jadi titik duanya tidak merugikan tetapi juga tidak berpengaruh.
• Jira dan Confluence — Jira modern mengubah tabel Markdown yang ditempel. Confluence lama memakai markup tabelnya sendiri, jadi tempelkan ke makro Markdown alih-alih ke badan halaman.
• Generator situs statis — Jekyll, Hugo, Docusaurus, MkDocs, dan Astro semuanya merender tabel GFM di berkas konten. Keluaran ringkas menjaga diff sumber tetap kecil ketika tabel dibuat ulang dari data.

Tabel Markdown dipakai di README, dokumentasi, dan situs statis. Mengonversi CSV ke Markdown memungkinkan Anda menyisipkan data tabel ke dalam konten berbasis Markdown, dan menjaganya di kendali versi yang sama dengan kode yang didokumentasikannya.

• Dokumentasi dan README — Taruh tabel di dokumentasi tanpa mengetik satu pipe pun, dan tanpa tangkapan layar yang kedaluwarsa begitu angkanya berubah.
• Teks yang mudah dipindah — Markdown menjaga data tetap terbaca di repositori, wiki, dan generator statis — dan terbaca sebagai teks biasa ketika tidak ada yang merendernya.
• Bisa ditinjau di diff — Tabel yang disimpan sebagai teks menunjukkan apa yang berubah baris demi baris dalam pull request. Lembar kerja yang dilampirkan pada commit yang sama tidak menunjukkan apa-apa.
• Tanpa dependensi untuk dipasang — Hasilnya adalah teks. Ia tidak butuh plugin, ekstensi, atau lingkungan eksekusi di mana pun ia mendarat, dan itu tidak berlaku bagi lembar tersemat atau gambar grafik.

• Pemisah — Deteksi otomatis berdasarkan konsistensi, atau pilih koma, titik koma, tab, atau pipe.
• Tanda kutip — Deteksi otomatis, kutip ganda, apostrof, atau tanpa.
• Pengkodean — Otomatis dengan deteksi byte-order mark, UTF-8, UTF-16LE, UTF-16BE, Windows-1252, atau ISO-8859-1 yang sesungguhnya.
• Baris pertama sebagai header — Menyala, baris satu adalah header tabel; mati, semua baris adalah data dan label Col 1, Col 2 dibuat otomatis.
• Perataan — Kiri, tengah, kanan, atau tanpa untuk tabel, dapat ditimpa per kolom dari kepala pratinjau.
• Keluaran rapi — Sejajarkan kolom di berkas mentah, atau biarkan ringkas untuk diff yang lebih kecil.
• Escape karakter Markdown — Meng-escape tanda bintang, garis bawah, backtick, kurung siku, tanda kurung sudut, dan tilde, selain pipe dan backslash yang selalu di-escape.
• Pergantian baris dalam sel — Ubah pergantian menjadi <br>, \n harfiah, atau spasi.
• Baris bernomor, baris dan kolom tebal — Satu kolom penghitung, satu baris data pertama tebal, dan satu kolom pertama tebal — masing-masing terpisah.
• Lewati, batasi, dan rapikan — Buang baris awal, batasi jumlah baris, dan singkirkan baris serta kolom yang tidak berisi apa pun.
• Unduh sebagai — Nama berkas kustom untuk .md; ekstensinya ditambahkan bila Anda tidak menuliskannya.

• CSV ke JSON
• CSV ke XML
• CSV ke Excel
• Alat CSV
• An OpenDocument spreadsheet

  Same typed columns and frozen header, for readers who use LibreOffice rather than Excel

• Cut it down first

  A README wants the rows that matter, not all forty thousand of them