AI di perangkat — profesional dan privat.

Dokumen

Cara Mengonversi JSON ke YAML dan YAML ke JSON (Tanpa Merusak Nilainya)

Konversi JSON ke YAML atau YAML ke JSON untuk Kubernetes, Docker Compose, dan CI. Pahami masalah Norwegia, jebakan tab dan indentasi, serta apa yang hilang.

Diperbarui 7 November 2026Baca 8 menit

Untuk mengonversi JSON ke YAML, tempel JSON ke konverter JSON ke YAML, pilih parser yang akan membaca YAML Anda, lalu klik Konversi ke YAML. Untuk arah sebaliknya, tempel YAML ke konverter YAML ke JSON. Keduanya hanya butuh beberapa detik. Yang perlu dibaca adalah apa yang bisa salah: YAML menebak tipe dari kata tanpa tanda kutip, sehingga kode negara seperti no bisa menjadi false, izin file bisa menjadi angka lain, dan tanggal bisa berhenti menjadi teks. Panduan ini membahas kedua arah, jebakan tersebut, dan apa yang hilang di tengah jalan.

Dua arah, dua alat

JSON dan YAML menggambarkan jenis data yang sama: objek, daftar, teks, angka, benar atau salah, dan null. JSON ketat dan ramai, dengan kurung kurawal, kurung siku, dan tanda kutip di mana-mana. YAML membuang sebagian besar itu dan memakai indentasi sebagai gantinya, sehingga orang lebih suka memakainya untuk file yang diedit dengan tangan. Setiap arah punya alatnya sendiri, dengan batasnya sendiri.

Anda punyaAnda inginAlatBatas gratis
JSON, respons API, atau hasil eksporYAMLJSON ke YAMLSatu file hingga 10 MB
Konfigurasi atau manifes YAMLJSONYAML ke JSONSatu file hingga 25 MB
JSON yang tidak bisa diuraiJSON yang sudah diperbaikiValidator JSONLihat halaman alatnya
JSON berantakan dalam satu barisJSON yang mudah dibacaPemformat JSONLihat halaman alatnya

Batasnya berbeda karena pekerjaannya berbeda. Mengubah JSON menjadi YAML berarti menyimpan seluruh dokumen sebagai objek hidup selagi YAML ditulis, sehingga alat itu berhenti di 10 MB. Membaca YAML memindai teksnya, jadi ada ruang hingga 25 MB.

Mengonversi JSON ke YAML, langkah demi langkah

1

Tambahkan JSON Anda

Buka konverter JSON ke YAML. Tempel JSON ke editor lalu klik Gunakan JSON ini, atau jatuhkan file .json, .ndjson, atau .jsonl ke halaman.

2

Pilih Parser tujuan

Bawaannya adalah Portabel, yang memberi tanda kutip pada setiap nilai yang akan dibaca sebagai tipe lain oleh pembaca YAML lama atau yang mengenali tanggal. YAML 1.2 hanya memberi kutip pada yang dibutuhkan parser modern. Kutip semua membungkus setiap string dengan kutip saat Anda tidak tahu apa yang akan membaca file itu.

3

Atur tata letak

Pilih Indentasi 1 sampai 8 spasi (2 adalah bawaan), Gaya null berupa null, ~, atau kosong, dan apakah file diawali ---.

4

Konversi lalu baca lencananya

Klik Konversi ke YAML. Dengan Verifikasi hasilnya aktif, YAML dibaca kembali oleh parser independen dan dibandingkan dengan JSON Anda. Lencana menyatakan Terverifikasi, atau menyebut jalur pertama tempat sebuah nilai kembali berbeda.

5

Unduh atau salin

Gunakan Unduh YAML atau Salin. Pratinjau menampilkan baris-baris awal untuk file besar, tetapi unduhannya adalah hasil lengkap.

Mengonversi YAML ke JSON

Tempel YAML ke konverter YAML ke JSON atau jatuhkan file .yaml atau .yml. Tombol contoh Kubernetes, Docker Compose, dan GitHub Actions memuat file khas agar Anda melihat hasilnya lebih dulu. Semua pengaturan keluaran gratis:

  • Indentasi: 2 spasi, 4 spasi, Tab, atau Diperkecil (satu baris, tanpa spasi kosong).
  • Dokumen: Otomatis (satu dokumen menjadi objek, beberapa menjadi larik), Selalu larik, Hanya pertama, atau Berkas terpisah, satu .json per dokumen.
  • Urutkan kunci: menaruh kunci setiap objek dalam urutan tetap agar dua konversi mudah dibandingkan.
  • Kunci ganda: Tolak, yang menyebut barisnya, atau Pakai yang terakhir.
  • NaN dan Infinity: Tulis null, Sebagai teks, atau Hentikan. JSON tidak punya nilai untuk .nan atau .inf.
  • Stempel waktu: Seperti ditulis, atau ISO 8601.

Anchor dan alias dibentangkan di mana pun dipakai, dan kunci merge seperti <<: *common diselesaikan, dengan kunci yang ditulis langsung pada mapping menimpa kunci hasil merge. Tag seperti !Ref disederhanakan menjadi nilai di bawahnya, dan nama tag didaftar di bawah hasil.

Pilih parser, konversi, dan dapatkan hasil yang terverifikasi. Gratis: satu file hingga 10 MB, dengan semua pengaturan yang memengaruhi ketepatan. Pro: hingga 50 file dalam satu ZIP, plus gaya keluaran. Semuanya berjalan di perangkat Anda, bukan di server kami.

Konversi JSON ke YAML

Masalah Norwegia dan perubahan tipe diam-diam lainnya

Di YAML 1.1, versi yang masih dipakai PyYAML, Ansible, dan Psych milik Ruby, kata polos yes, no, on, off, y, dan n adalah boolean. Daftar kode negara yang berisi NO (Norwegia) karenanya kembali dengan false di tempatnya. Tidak ada kesalahan yang dilaporkan; datanya saja yang salah. YAML 1.2 menghapus aturan itu, sehingga sebagian parser membaca file yang sama secara berbeda dari yang lain. Ketidaksepakatan itulah alasan pengaturan Parser tujuan ada.

Nilai di JSON AndaYang bisa dilakukan pembaca YAML lama terhadapnyaTujuan Portabel
"no", "yes", "on", "off"Boolean, sehingga "no" menjadi falseDikutip
"0755"Bilangan oktal, 493Dikutip
"1:30"Bilangan basis 60, 90Dikutip
"2024-01-01"Objek tanggal, bukan teksDikutip
"true", "null", "12"Boolean, null, atau angka, di setiap versi YAMLDikutip (di semua mode)
"hello"TeksDibiarkan polos

Portabel memberi kutip tepat pada nilai-nilai di tabel itu dan membiarkan kata biasa, sehingga file tetap mudah dibaca. Mode YAML 1.2 memberi kutip lebih sedikit dan hanya benar jika yang membaca file adalah parser 1.2 tanpa penanganan tanggal; alat tetap menghitung berapa nilai yang akan diubah pembaca lama dan memberi tahu Anda. Kunci diberi kutip dengan aturan yang sama, karena kunci n atau yes tanpa kutip menjadi boolean pada pembaca 1.1. Untuk arah sebaliknya, YAML ke JSON mengikuti aturan YAML 1.2: yes, no, on, dan off tetap string, dan stempel waktu seperti 2001-12-14 tetap teks yang Anda ketik kecuali Anda memilih ISO 8601.

Indentasi, tab, dan nilai kosong

Struktur YAML adalah indentasi. Dua spasi lebih banyak berarti anak; indentasi yang sama berarti saudara. Satu baris yang menjorok satu spasi terlalu jauh mengubah bentuk data atau menghentikan pengurai. Tab adalah kegagalan klasik: YAML melarangnya untuk indentasi, dan file yang tampak rata di editor dengan tab stop bisa menolak dimuat. Konverter YAML ke JSON melaporkan baris dan kolom kesalahannya, dengan beberapa baris dari sumber Anda sendiri dan penanda di bawahnya. Ganti tab dengan spasi lalu konversi lagi.

JSON ke YAML tidak punya risiko itu, karena alat yang menulis indentasinya. Wadah kosong ditulis sebagai {} dan [] alih-alih dibiarkan kosong, karena nilai kosong dibaca kembali sebagai null. Teks dengan baris baru menjadi blok | yang mudah dibaca, sehingga skrip atau sertifikat tetap berbaris. Jika sebuah blok tidak bisa mewakili teks secara persis, misalnya baris pertamanya kosong atau menjorok, atau ada carriage return, teks diberi kutip. Perubahan diam-diam lebih buruk daripada keluaran yang jelek.

Yang hilang saat menjadi JSON: komentar dan node bersama

JSON tidak punya komentar. Saat Anda mengonversi YAML ke JSON, setiap komentar # dibuang, begitu pula dokumentasi yang dibawanya. Simpan YAML sebagai sumber kebenaran dan perlakukan JSON sebagai hasil build. Dari JSON ke YAML Anda mendapat kemampuan menulis komentar, tetapi memulai tanpa satu pun, jadi tambahkan setelah konversi.

Alias juga diratakan. Dua tempat yang merujuk satu anchor menjadi dua salinan identik di JSON, karena JSON tidak bisa menyatakan bahwa keduanya node yang sama. Mengonversi balik memberi YAML yang lebih panjang daripada aslinya. Alias sirkular, tempat anchor merujuk dirinya sendiri, adalah YAML yang sah tetapi mustahil di JSON, dan konverter melaporkannya beserta jalurnya alih-alih gagal diam-diam.

Pemakaian umum: Kubernetes, Docker Compose, dan file CI

  • Kubernetes: manifes yang dipisahkan --- berisi beberapa dokumen. Gunakan Otomatis atau Selalu larik untuk mendapatkannya sebagai JSON bagi alat yang memerlukannya, atau Berkas terpisah untuk satu .json masing-masing. Saat ke YAML, atur tata letak lalu periksa lencananya, karena label versi seperti "1.20" harus tetap teks.
  • Docker Compose: layanan yang didefinisikan dengan <<: *common keluar dengan kunci bersama sudah digabung. Pemetaan port seperti "22:22" adalah jebakan versi 1.1 dalam praktik, karena 22:22 polos bisa dibaca sebagai bilangan basis 60. Portabel memberinya kutip.
  • File CI seperti alur kerja GitHub Actions: kunci on tetap string "on", bukan true. Itu bacaan yang benar bagi parser 1.2. Untuk membandingkan dua file alur kerja, konversi keduanya dengan Urutkan kunci aktif; itu mengubah urutan, bukan makna.
  • Payload API: ubah respons JSON menjadi konfigurasi YAML awal, atau ubah file pengaturan YAML menjadi body untuk layanan yang tidak bisa membaca YAML.

Untuk melihat perbedaan dua konfigurasi, konversi keduanya, urutkan kuncinya, dan bandingkan JSON-nya; perubahan urutan dan komentar tidak lagi muncul sebagai perbedaan. Untuk merapikan JSON lebih dulu, lihat cara memformat JSON online, dan untuk sumber XML, mengonversi XML ke JSON.

Saat konversi gagal

Jika JSON tidak bisa diurai, konverter menampilkan baris dan kolom, penanda di bawah karakter yang tepat, dan apa yang diharapkan di sana. Penyebab umumnya adalah koma di akhir, kutip tunggal alih-alih ganda, komentar, atau kunci tanpa kutip. Validator JSON mendaftar kesalahan dalam satu kali jalan, dan Pemformat JSON membuat strukturnya lebih mudah dilihat. Perbaiki sintaksnya, lalu konversi lagi.

  • File terlalu besar: batas gratisnya 10 MB untuk JSON ke YAML dan 25 MB untuk YAML ke JSON. Pecah file, atau gunakan Pro.
  • Banyak file sekaligus: Gratis mengonversi satu per satu. Pro mengantrekan hingga 50 dan mengunduhnya sebagai satu ZIP; YAML ke JSON juga bisa menggabungkan semua dokumen dari semua file ke dalam satu larik.
  • Kunci ganda di YAML: bawaannya menolak dan menyebut kunci kedua. JSON tidak bisa menampung keduanya, jadi pilih Pakai yang terakhir hanya jika Anda tahu nilai mana yang diinginkan.
  • Nilai berbeda setelah konversi: pesan Verifikasi gagal menyebut jalur dan kedua tipe, misalnya string yang kembali sebagai tanggal. Ubah Parser tujuan ke Portabel.

Pertanyaan umum

Bagaimana cara mengonversi JSON ke YAML?

Tempel JSON Anda ke konverter JSON ke YAML, pilih Parser tujuan (Portabel adalah bawaan), lalu klik Konversi ke YAML. Setelah itu unduh file .yaml atau salin. Paket gratis menangani satu file hingga 10 MB.

Bagaimana cara mengonversi YAML ke JSON?

Tempel YAML atau jatuhkan file .yaml atau .yml ke konverter YAML ke JSON. Pilih indentasi, cara memperlakukan beberapa dokumen, dan apakah kunci diurutkan, lalu unduh hasilnya. Paket gratis menangani satu file hingga 25 MB.

Apa itu masalah Norwegia di YAML?

Di YAML 1.1 kata no tanpa kutip adalah boolean, sehingga kode negara NO untuk Norwegia dibaca sebagai false. Memberi kutip pada nilainya menyelesaikan masalah itu. Konverter JSON ke YAML melakukannya untuk Anda saat Parser tujuan adalah Portabel.

Apakah komentar dipertahankan saat mengonversi YAML ke JSON?

Tidak. JSON tidak punya komentar, jadi setiap komentar # dibuang. Simpan YAML sebagai sumber dan hasilkan JSON darinya, alih-alih mengedit JSON dengan tangan.

Mengapa YAML saya gagal dengan kesalahan tab?

YAML tidak mengizinkan tab untuk indentasi, meskipun file tampak rata di editor Anda. Ganti tab dengan spasi. Konverter YAML ke JSON menyebut baris dan kolom tempat ia berhenti.

Bisakah saya mengonversi file Kubernetes atau Docker Compose?

Bisa. Manifes dengan beberapa dokumen yang dipisahkan --- dikonversi menjadi larik, dokumen pertamanya, atau satu file per dokumen. Anchor, alias, dan kunci merge diselesaikan. Semuanya berjalan di perangkat Anda, bukan di server kami, sehingga nama host dan nama image tidak diunggah.

Baca juga

Lainnya tentang Dokumen →