Konversi JSON ke YAML JavaScript Object Notation ↔ YAML Ain't Markup Language Gratis Daring Aman
Jatuhkan sebuah berkas JSON dan bawa pulang YAML. Pembacaan dan penulisannya terjadi di sini, di peramban Anda, jadi berkasnya tidak meninggalkan perangkat — dan apa yang dipertahankan penyeberangan itu, serta apa yang tidak bisa, tertulis di bawah, bukan dibiarkan untuk Anda temukan sendiri.
Konversikan berkas Anda
Jatuhkan berkas JSON di sini, atau pilih satu.
Berkas Anda tidak meninggalkan perangkat ini. Semuanya berjalan di peramban Anda.
Tidak ada unggahan
Mengubah dari JSON
Mengubah menjadi JSON
Dari mana format-format ini berasal
CSV paling tua dan paling kurang dibakukan: sebuah tabel yang ditulis sebagai baris-baris teks, dipakai sejak tahun 1970-an dan baru diuraikan secara tertulis pada 2005, ketika tiap program sudah memutuskan sendiri apa pemisahnya dan kapan tanda kutip dipasang. XML tumbuh dari SGML pada 1998, untuk dokumen yang harus membawa struktur ketat dan diperiksa terhadap sebuah skema. JSON ditarik keluar dari JavaScript oleh Douglas Crockford sekitar 2001, sengaja dipangkas hingga tinggal objek, larik, bilangan, dan untaian — dan kesederhanaan itulah sebabnya ia menguasai web. YAML adalah sepupunya yang mudah dibaca, tempat indentasi mengerjakan apa yang di tempat lain dikerjakan kurung. Saat mengubah di antara keduanya, hanya satu hal yang penting: CSV itu datar, sebuah kisi baris dan kolom, sedangkan JSON, XML, dan YAML adalah pohon.
Di mana Anda menemuinya
CSV adalah yang diekspor lembar hitung dan yang diserahkan kepada Anda oleh akuntan, lapak daring, atau rekening koran. JSON adalah bahasa yang dipakai layanan web dan makin lama makin menjadi bahasa berkas konfigurasi. XML bertahan pada sistem perusahaan yang lebih tua, pada standar penagihan, dan di dalam format perkantoran itu sendiri. YAML adalah tempat manusia menulis setelan dengan tangan. Mengubah di antara mereka adalah pekerjaan sehari-hari memindahkan data dari tempat ia dihasilkan ke tempat ia dibutuhkan.
Pertanyaan yang sering diajukan
CSV saya terbuka sebagai satu kolom di Excel. Mengapa?
Karena lembar hitung Anda mengharapkan pemisah yang lain. Excel mengikuti pemisah daftar pada setelan wilayah komputer, dan itu titik koma di mana pun koma sudah menjadi tanda desimal — yaitu di sebagian besar Eropa daratan. Berkas yang dipisah koma lalu tampak sebagai satu kolom teks. Pakailah kotak impor dan sebutkan pemisahnya dengan tegas, alih-alih membuka berkas dengan klik ganda. Setelan wilayah yang sama pula yang membuat 3.5 kadang tiba sebagai tanggal.
Mengapa JSON saya yang bersarang tak bisa menjadi lembar hitung yang rapi?
Karena lembar hitung itu datar dan JSON adalah pohon. Satu baris memuat satu nilai per kolom; satu objek JSON bisa memuat daftar di dalam sebuah ruas di dalam daftar lain. Mengubahnya berarti memilih cara memipihkannya: menggabungkan nama-nama bersarang menjadi satu judul kolom yang panjang, atau mengulang baris induk sekali untuk tiap anak. Keduanya adalah kompromi, dan tak satu pun dapat dibatalkan secara otomatis — karena itu kembali dari lembar hitung ke bentuk semula biasanya memerlukan keputusan manusia.
Apakah berkasnya kehilangan mutu?
Bergantung pada apa yang sanggup dimuat kedua format. Mengubah antara format yang menyimpan hal yang sama — PNG ke BMP, WAV ke FLAC — tidak kehilangan apa pun. Mengubah ke format yang membuang keterangan demi menghemat ruang, seperti JPEG atau MP3, kehilangan sedikit setiap kali, dan kembali lagi tidak mengembalikannya. Bila ada pilihan, halaman ini condong menjaga mutu asli ketimbang menghasilkan berkas terkecil.
Apakah berkas saya diunggah ke suatu tempat?
Tidak. Konversinya berlangsung di dalam peramban Anda, pada mesin Anda sendiri; berkas itu tak pernah meninggalkannya, dan di sini memang tak ada server yang dapat menerimanya. Karena itu berkas besar dibatasi oleh memori Anda sendiri, bukan oleh unggahan; dan karena itu tak satu pun yang Anda ubah dapat muncul dalam catatan siapa pun — termasuk catatan kami. Alat suara dan video memang mengambil mesin konversinya dari situs ini pada pemakaian pertama — sekitar tiga puluh megabita, sekali saja; setelah itu pekerjaannya tetap berlangsung sepenuhnya di mesin Anda.
Mengapa orang konversi JSON ke YAML
JSON adalah notasi yang disukai program: ketat, ringkas, dan dipahami setiap bahasa. Tetapi ia tidak ramah kepada manusia. Berkas JSON yang panjang adalah semak belukar kurung kurawal, kurung siku, tanda kutip, dan koma, tanpa ruang untuk komentar dan dengan koma di ujung yang dapat merusak segalanya. YAML adalah notasi yang dipilih orang ketika mereka harus membaca dan menyunting data dengan tangan. Ia memakai indentasi sebagai ganti kurung kurawal, mengizinkan komentar, dan terbaca hampir seperti kerangka tulisan, itulah sebabnya ia menjadi favorit untuk konfigurasi: pipeline build, definisi kontainer, berkas penerapan, pengaturan situs statis dan alat dokumentasi. Ketika data tiba sebagai JSON dan Anda ingin mengerjakannya dalam bentuk yang nyaman dibaca, konversi diperlukan. Itulah sebabnya orang konversi JSON ke YAML.
Situasinya sehari-hari. Pengembang yang punya keluaran sebuah alat dalam JSON dan ingin mengubahnya menjadi berkas konfigurasi. Tim yang memindahkan pengaturan dari satu sistem ke sistem lain dan lebih suka format yang terbaca. Penulis yang ingin membaca struktur jawaban API tanpa kekusutan. Pelajar yang ingin melihat bagaimana kurung kurawal dipetakan ke indentasi. Dalam setiap kasus datanya sama, dan hanya notasinya yang berubah.
Halaman ini mengonversi JSON ke YAML di browser Anda. Berkas Anda dibaca dan ditulis di sini, jadi tidak pernah meninggalkan perangkat Anda, yang penting untuk berkas konfigurasi, yang sering memuat alamat, nama sistem internal, dan kadang rahasia. Dan halaman ini memberi tahu Anda di muka apa yang dipertahankan penyeberangan itu dan apa yang tidak bisa, alih-alih membiarkan Anda menemukannya sendiri. Di bawah ini Anda akan menemukan cara kerja konversi, apa yang terjadi dengan persarangan dalam dan string panjang, dan cara mendapat hasil yang rapi.
Cara kerja konversi
Bentuk yang sama dalam kedua notasi
JSON Anda dibaca di dalam browser Anda, dan strukturnya ditulis sebagai YAML. Keduanya memuat bentuk yang sama, dan semuanya dipertahankan ke kedua arah: peta, daftar, string, angka, boolean, dan null. Objek di JSON menjadi pemetaan di YAML, larik menjadi urutan, dan nilai skalar mempertahankan tipenya. Kunci port dengan angka 8080 menghasilkan port: 8080, dan kunci enabled dengan true menghasilkan enabled: true.
Struktur berulang ditulis lengkap
YAML punya cara menghindari pengulangan, dengan jangkar dan alias. Konverter tidak memakainya. Struktur berulang ditulis lengkap alih-alih sebagai jangkar, jadi berkas terbaca lurus ke bawah. Ini membuat YAML sedikit lebih panjang, tetapi tidak ada isinya yang perlu dicari di tempat lain, dan pembaca mana pun dapat memahami setiap blok dengan sendirinya.
Kunci mempertahankan urutannya
Kunci mempertahankan urutan seperti yang dimiliki JSON. YAML terbaca dalam urutan yang sama dengan sumbernya, jadi orang yang mengenal JSON-nya akan langsung menemukan jalan.
Apa yang dipertahankan
Semua yang berupa data
Semuanya dipertahankan, ke kedua arah: peta, daftar, string, angka, boolean, dan null. Jika itu nilai di JSON Anda, itu nilai di YAML, dengan tipe yang sama.
String yang memerlukan perlindungan
Sebagian string akan salah dibaca di YAML jika ditulis polos: kata true, angka dalam tanda kutip, teks yang memuat titik dua. Konverter memberi kutip pada string seperti itu agar kembali sebagai string dan tidak berubah menjadi boolean atau angka. String JSON yang berkata “true” tetap string di YAML.
Unicode
Huruf beraksen, simbol, dan karakter dari alfabet lain dipertahankan apa adanya, jadi berkas dalam beberapa bahasa tetap terbaca.
Apa yang perlu Anda ketahui sebelum konversi JSON ke YAML
Persarangan dalam berarti indentasi dalam
YAML menaruh makna pada indentasinya, jadi nilai yang berakhir bersarang dalam menjadi berkas yang berindentasi dalam: terbaca, tetapi tidak pendek. Pohon JSON delapan tingkat menghasilkan baris yang dimulai jauh dari tepi kiri. Jika itu menjadi sulit ditangani, pertimbangkan meratakan struktur di sumbernya.
String panjang dibungkus
String panjang dibungkus pada sekitar seratus kolom, yang mengubah di mana pemisah baris jatuh tanpa mengubah nilainya. Paragraf yang berupa satu baris panjang di JSON tampak dalam beberapa baris di YAML, tetapi itu teks yang sama. Program yang membaca YAML menerima string aslinya.
Komentar tidak dapat diciptakan
YAML mengizinkan komentar, tetapi JSON tidak membawa satu pun, jadi hasilnya tidak punya. Anda dapat menambahkan penjelasan dengan tangan sesudahnya, yang merupakan salah satu alasan utama memiliki berkas dalam YAML sejak awal.
Cara konversi JSON ke YAML di sini
Tambahkan berkas Anda
Jatuhkan berkas JSON ke halaman atau pilih dari perangkat Anda. Ia dibaca di dalam browser Anda dan tidak diunggah.
Konversi
Tekan tombol. Berkas berukuran biasa memakan sebentar. Biarkan halaman terbuka sampai selesai.
Unduh dan periksa
Unduh YAML dan buka di penyunting teks. Lihat awal dan akhirnya, dan periksa bahwa struktur dan tipenya seperti yang Anda harapkan.
Melihat lebih dekat JSON dan YAML
Dua notasi untuk data yang sama
JSON dirancang agar mudah dibaca dan ditulis program. YAML dirancang agar mudah bagi orang. Keduanya tumpang tindih begitu jauh sehingga JSON hampir merupakan himpunan bagian YAML, dan pembaca YAML biasanya dapat membaca JSON. Untuk konversi JSON ke YAML karena itu bukan mengubah data melainkan mendandaninya kembali, dalam bentuk yang punya ruang untuk catatan dan tanpa kekusutan tanda baca.
Mengapa indentasi memerlukan kehati-hatian
Karena YAML bergantung pada indentasi, baris yang tidak sejajar mengubah makna. Konverter menulis indentasi secara konsisten, dengan spasi dan dengan lebar yang sama pada setiap tingkat, jadi berkas benar seperti yang dihasilkan. Ketika Anda menyuntingnya nanti, pertahankan lebar yang sama, dan hindari tab, yang tidak diizinkan YAML untuk indentasi.
Terbaca tetapi tidak selalu lebih pendek
YAML sering digambarkan lebih ringkas daripada JSON, karena ia membuang kurung kurawal dan tanda kutip di sekitar kunci. Untuk data datar ini benar. Untuk data yang sangat bersarang, indentasi dapat membuatnya lebih panjang dalam karakter. Keuntungannya ada pada keterbacaan, bukan ukuran.
Situasi umum secara rinci
Mengubah keluaran alat menjadi konfigurasi
Alat sering mencetak pengaturan atau hasilnya sebagai JSON. Konversi JSON ke YAML, tambahkan komentar, dan simpan sebagai berkas konfigurasi yang dipelihara orang.
Memindahkan pengaturan antarsistem
Memindahkan konfigurasi dari sistem yang memakai JSON ke yang memakai YAML cukup satu konversi, diikuti pemeriksaan bahwa target menerima kuncinya.
Membaca jawaban API
Jawaban sebuah API bisa mencapai ratusan baris kurung kurawal. Dalam YAML, data yang sama terbaca seperti kerangka tulisan, dan Anda dapat melihat strukturnya sekilas.
Pengajaran dan dokumentasi
Menunjukkan data yang sama dalam kedua notasi adalah cara yang baik untuk mengajarkan cara kerja data terstruktur. Dokumentasi yang memakai contoh YAML sering lebih mudah dibaca.
Saran praktis sebelum Anda konversi JSON ke YAML
Periksa bahwa JSON valid
Koma yang tersesat atau tanda kutip yang hilang akan menghentikan konversi. Jika halaman melaporkan kesalahan, buka berkas di penyunting yang menyorot masalah JSON dan perbaiki baris yang ditunjuknya.
Ratakan di mana Anda bisa
Jika struktur lebih dalam daripada yang diperlukan, sederhanakan lebih dulu. Struktur yang lebih datar menghasilkan YAML yang lebih mudah dibaca dan disunting.
Pikirkan tentang konsumennya
Lihat apa yang akan membaca YAML. Sebagian alat mengharapkan nama kunci dan tipe tertentu, dan lebih mudah menyesuaikan JSON sebelumnya daripada menyunting YAML sesudahnya.
Berkas besar
Semuanya berjalan di perangkat Anda, jadi berkas yang sangat besar memerlukan memori. Untuk berkas berukuran banyak megabyte, pakai komputer, dan pecah datanya jika halaman kesulitan.
Pertanyaan yang diajukan orang sebelum mengonversi
Apakah data saya akan berubah?
Tidak. Semuanya dipertahankan ke kedua arah: peta, daftar, string, angka, boolean, dan null.
Mengapa string panjang saya terbagi dalam beberapa baris?
String panjang dibungkus pada sekitar seratus kolom. Ini mengubah di mana pemisah baris jatuh tanpa mengubah nilainya.
Mengapa berkas saya begitu berindentasi?
Karena datanya bersarang dalam, dan YAML menyatakan persarangan dengan indentasi.
Di mana jangkarnya?
Struktur berulang ditulis lengkap alih-alih sebagai jangkar, jadi berkas terbaca lurus ke bawah.
Apakah berkas saya diunggah?
Tidak. Konversi berjalan di browser Anda dan berkas tidak pernah meninggalkan perangkat Anda.
Bisakah saya kembali ke JSON?
Ya. YAML ke JSON membaca berkas kembali, meskipun komentar apa pun yang Anda tambahkan tidak akan bertahan.
Memilih dengan bijak saat konversi JSON ke YAML
Apakah YAML benar-benar diperlukan?
Jika alat penerima membaca JSON, simpan JSON. Konversi ketika orang harus membaca dan menyunting berkas, atau ketika alat memerlukan YAML.
Target lain
Jika tujuannya berkas markup, JSON ke XML dapat menyusul. Untuk tabel, JSON ke CSV dan JSON ke XLSX melayani spreadsheet.
Simpan JSON-nya
JSON adalah induknya jika berasal dari program. Simpan, dan buat ulang YAML ketika ia berubah.
Mendapatkan hasil yang baik setelah konversi
Tambahkan komentar
Hasilnya tidak punya, dan di sinilah YAML bersinar. Tambahkan catatan singkat di atas setiap blok untuk mengatakan apa yang dilakukannya dan nilai apa yang diizinkan.
Periksa tipenya
Lihat nilai seperti versi, kode, dan penanda. Pastikan mereka string di mana Anda maksudkan string dan angka di mana Anda maksudkan angka.
Jaga indentasi tetap konsisten
Ketika Anda menyunting, pakai spasi dan pertahankan lebar yang sama pada setiap tingkat. Penyunting yang menampilkan spasi putih dan memeriksa YAML akan menyelamatkan Anda dari kesalahan.
Menyiapkan JSON Anda agar terkonversi dengan baik
Jaga tetap teratur
Ketika Anda konversi JSON ke YAML, data teratur terkonversi paling baik: kunci konsisten dan tipe yang jelas. Data tak teratur menghasilkan hasil yang benar tetapi tidak rapi.
Beri nama kunci dengan jelas
Orang akan membaca YAML, jadi pilih kunci yang mengatakan apa maksudnya. Konfigurasi lebih mudah dipelihara ketika namanya polos.
Uji dulu dengan potongan kecil
Jika berkas Anda besar, ambil satu bagian ke berkas uji dan konversi itu. Sekilas melihat hasilnya menunjukkan apakah strukturnya seperti yang Anda harapkan.
Bekerja dengan YAML setelah Anda konversi JSON ke YAML
Tambahkan catatan yang tidak dapat dimuat JSON
Hal pertama yang dilakukan dengan berkas yang baru dikonversi adalah membacanya dari atas dan menambahkan komentar di mana orang asing akan bingung. Satu baris pendek di atas satu bagian yang mengatakan apa yang dikendalikannya lebih bernilai daripada satu halaman dokumentasi yang disimpan di tempat lain, karena ia berada di samping hal yang dijelaskannya. Ini keuntungan utama yang Anda dapat ketika Anda konversi JSON ke YAML.
Kelompokkan pengaturan yang berkaitan
Kunci mempertahankan urutan yang dimilikinya di JSON, yang mungkin urutan yang kebetulan dikeluarkan program. Di YAML Anda bebas menata ulang agar pengaturan yang berkaitan berdekatan, dengan satu baris kosong di antara kelompok. Karena urutan kunci dalam pemetaan tidak bermakna bagi sebagian besar pembaca, ini aman, tetapi periksa alat yang Anda pakai kalau-kalau ia peduli.
Periksa apa yang diharapkan alat penerima
Berkas YAML yang valid belum tentu konfigurasi yang valid. Alat mengharapkan kunci dan tipe tertentu, dan sebagian ketat terhadap kunci yang tidak dikenal. Setelah konversi, bandingkan berkas dengan dokumentasi alat, dan jalankan pemeriksanya sendiri jika ada.
Pakai kendali versi
Konfigurasi dalam YAML mudah dibandingkan baris demi baris, yang menjadikannya cocok untuk kendali versi. Komit berkas yang dikonversi dan biarkan rekan melihat setiap perubahan sebagai selisih yang jelas, yang jauh lebih sulit dengan satu baris JSON yang diperkecil.
Waspadai rahasia
JSON yang diekspor dari alat kadang menyertakan token dan kata sandi. Karena konversi terjadi di browser Anda, tidak ada yang meninggalkan perangkat Anda, tetapi berkas YAML akan memuat rahasia yang sama. Hapus, atau pindahkan ke tempat yang lebih aman, sebelum Anda mengomit atau membagikan berkas.
Awasi indentasi saat menyunting
Begitu Anda mulai menyunting dengan tangan, risiko utamanya adalah baris yang bergeser satu spasi. Pakai penyunting yang menampilkan spasi putih dan memeriksa YAML saat Anda mengetik, dan pertahankan lebar yang sama pada setiap tingkat, seperti yang dilakukan konverter.
Konversi lagi ketika sumber berubah
Jika JSON dihasilkan program dan berubah dari waktu ke waktu, konversi JSON ke YAML lagi untuk setiap versi baru, dan gabungkan komentar Anda dari berkas lama ke yang baru. Alat pembanding menjadikannya urusan beberapa menit.
Privasi dan penanganan
Mengapa konversi lokal penting untuk konfigurasi
Berkas konfigurasi sering memuat alamat, nama sistem internal, dan kadang kunci dan kata sandi. Banyak konverter daring mengunggah berkas Anda ke server, memprosesnya, dan mengirim kembali hasilnya, dan selama beberapa waktu salinannya berada di mesin yang tidak Anda kendalikan. Di sini browser Anda sendiri yang bekerja, jadi berkas tetap di perangkat Anda.
Apa yang terjadi ketika Anda pergi
Ketika Anda menutup halaman, berkas hasil konversi hilang dari browser, jadi unduh dulu. Tidak ada yang tentang berkas Anda disimpan.
Jika ada yang salah
Halaman berkata berkas bukan JSON yang valid
Mungkin ada koma yang tersesat, tanda kutip yang hilang, atau kurung yang tidak tertutup. Buka berkas di penyunting yang menyorot kesalahan JSON dan perbaiki baris yang ditunjuknya.
Alat menolak YAML
Periksa nama kunci dan tipe yang diharapkannya. YAML valid, tetapi alat mungkin menginginkan nama atau struktur yang berbeda.
Halaman membeku dengan berkas besar
Semuanya berjalan di perangkat Anda, dan berkas besar memerlukan memori. Coba lagi di komputer, atau pecah datanya.
Alat terkait
Keluarga alat yang sama mencakup pekerjaan di dekatnya. Untuk kembali, pakai YAML ke JSON. Untuk markup, JSON ke XML dan XML ke JSON mengonversi antara keduanya. Untuk tabel, ada JSON ke CSV, CSV ke JSON, JSON ke XLSX, dan XLSX ke JSON.
Contoh hitungan
Katakanlah sebuah alat mencetak pengaturannya sebagai berkas JSON 150 baris, dan Anda ingin menyimpannya di repositori sebagai konfigurasi yang dapat dibaca dan diberi komentar rekan. Anda menjatuhkan berkas di sini dan menekan tombol. Sesaat kemudian Anda mengunduh YAML sekitar 90 baris di mana strukturnya terbaca seperti kerangka tulisan. Anda menambahkan komentar di atas setiap bagian, mengomitnya, dan memberi tahu tim di mana menyunting. JSON tetap sebagai keluaran alat.
Daftar periksa singkat
Sebelum mengonversi
Periksa bahwa JSON valid. Sederhanakan persarangan dalam jika bisa. Simpan JSON.
Saat mengonversi
Tetaplah di halaman sampai berkas siap.
Setelah mengonversi
Buka YAML, periksa struktur dan tipe, tambahkan komentar, dan uji dengan alat yang akan membacanya.
Kekeliruan umum
Mengharapkan berkas yang lebih pendek
Persarangan dalam membuat indentasi dalam. YAML lebih terbaca, tidak selalu lebih kecil.
Menyunting dengan tab
YAML tidak mengizinkan tab untuk indentasi. Pakai spasi.
Kehilangan sumber
Jika JSON berasal dari program, simpan dan buat ulang YAML ketika ia berubah.
Berkas Anda tetap di perangkat Anda
Konversi terjadi secara lokal. Berkas Anda dibaca oleh browser Anda sendiri, ditulis ulang di sana, dan diserahkan kembali sebagai YAML. Tidak ada yang diunggah, jadi tidak ada salinan yang berakhir di server dan tidak ada orang lain yang dapat membacanya. Untuk konfigurasi dengan isi pribadi, itulah cara yang aman untuk konversi JSON ke YAML.
Ringkasan
Untuk konversi JSON ke YAML di sini, jatuhkan berkas dan tekan tombol. Ia dibaca dan ditulis di browser Anda, jadi berkas tidak pernah meninggalkan perangkat Anda. Semuanya dipertahankan, ke kedua arah: peta, daftar, string, angka, boolean, dan null. Struktur berulang ditulis lengkap alih-alih sebagai jangkar, jadi berkas terbaca lurus ke bawah. YAML menaruh makna pada indentasinya, jadi nilai yang berakhir bersarang dalam menjadi berkas yang berindentasi dalam, terbaca tetapi tidak pendek. String panjang dibungkus pada sekitar seratus kolom, yang mengubah di mana pemisah baris jatuh tanpa mengubah nilainya. Kunci mempertahankan urutan seperti yang dimiliki JSON.