YAML ve JSON nasıl dönüştürülür?

Yönü seçin, metni yapıştırın ve Dönüştür düğmesine basın. YAML'dan JSON'a giderken girinti genişliğini ya da sıkıştırılmış çıktıyı seçebilirsiniz; JSON'dan YAML'a giderken çıktı iki boşluk girintili blok biçimindedir. Dönüşüm her tuşta değil, düğmeyle çalışır. Çıktıyı kopyalayabilir ya da dosya olarak indirebilirsiniz.

Araç sonucu vermeden önce kendi çıktısını yeniden okur ve girdiyle aynı veri yapısına karşılık geldiğini doğrular. Uyuşmazlık olursa çıktı verilmez ve hata gösterilir.

Desteklenen altküme

Araç, YAML 1.2.2 çekirdek şemasının JSON ile ifade edilebilen kısmını kabul eder: tek belge; boş değer, mantıksal değer, metin, sonlu sayı, dizi ve anahtarları metin olan eşleme.

YapıDavranış
Birden çok belgeHata
Alias ve çapaHata, hiç genişletilmez
EtiketlerHata
Birleştirme anahtarıHata
Metin olmayan anahtarHata
Tekrar eden anahtarHata
Güvenli olmayan tam sayı, sonsuz ve sayı değilHata
YorumlarJSON'da kaybolur, uyarı verilir

Eşlemelerin sıralaması anlamsal bir garanti değildir. Araç kaynaktaki sırayı korur, ancak veriyi okuyan sistemin sıraya güvenmemesi gerekir.

Alias, etiket ve tekrar eden anahtarlar neden hata?

Alias ve çapalar bir değeri başka yerde yeniden kullanır. İç içe alias zincirleri küçük bir metni çok büyük bir veriye çevirebilir; ilk sürüm bu riski sıfır genişletme sınırıyla kapatır ve alias görürse durur. Etiketler ve birleştirme anahtarları da ayrıştırıcıya göre farklı anlam taşır. Tekrar eden anahtarlar ise birçok araçta sessizce son değeri kazandırır ve yapılandırmada fark edilmeyen hatalara yol açar. Araç bunun yerine konumu satır ve sütunla göstererek durur.

Sayılar, on ve yes, baştaki sıfır

YAML 1.2 çekirdek şemasında yalnızca true ve false (büyük harfli yazımlarıyla) mantıksal değerdir; on, off, yes ve no metindir. Bu yüzden GitHub Actions dosyalarındaki on: anahtarı JSON'da "on" olarak kalır, true olmaz. YAML 1.1 yükleyicileri bu sözcükleri mantıksal değer sayabilir; bu nedenle JSON'dan YAML'a çevirirken bu değerler tırnak içine alınır.

Baştaki sıfırlı sayılar belirsizdir: 007 YAML 1.1'de sekizlik olabilir, 1.2'de ondalık yedidir, JSON'da ise geçersizdir. Araç bu yazımı hata sayar; metin istiyorsanız "007" yazın. Onaltılık 0x1F, sekizlik 0o17, .inf ve .nan da JSON'da yoktur ve reddedilir. Tam sayılar, çift duyarlıklı sayıların güvenli aralığıyla (9007199254740991'e kadar) sınırlıdır. Üs veya ondalık işaretiyle yazılsa da daha büyük tam sayılar reddedilir. Ondalık metin, JavaScript sayı dönüşümünden sonra aynı ondalık değere dönemiyorsa hata verilir; bu denetim 0.1 gibi değerlerin ikili kayan noktada tam temsil edildiği anlamına gelmez. JSON yönünde de bu denetim JSON.parse sonrasında değil, metnin kendisi üzerinde yapılır.

Örnek dönüşüm

Aşağıdaki YAML, bu araçla ikinci kutudaki JSON'a dönüşür. Yorum satırı kaybolur, on metin anahtar olarak kalır ve | ile yazılan çok satırlı metin sonundaki satır sonuyla korunur.

# Örnek yapılandırma
name: Günlük derleme
on:
  schedule:
    - cron: "0 3 * * *"
version: 1.5
enabled: true
notes: |
  İki satırlı
  not
{
  "name": "Günlük derleme",
  "on": {
    "schedule": [
      {
        "cron": "0 3 * * *"
      }
    ]
  },
  "version": 1.5,
  "enabled": true,
  "notes": "İki satırlı\nnot\n"
}

Sınırlar ve gizlilik

  • Girdi en fazla 100 KiB UTF-8 olabilir, iç içe geçme en fazla 50 düzeydir ve toplam düğüm sayısı en fazla 10.000'dir; bunlar bu aracın tasarım sınırlarıdır.
  • Çok derin yapılar ayrıştırıcı yığınını zorlarsa araç çökmek yerine derinlik hatası gösterir.
  • Yapılandırmanızda gerçek parola veya anahtar varsa yerine yer tutucu yazın; araç hiçbir içeriği saklamaz, kaydetmez ve paylaşım bağlantısına koymaz.
  • Paylaş düğmesi yalnızca yön ve girinti ayarını bağlantıya ekler.
  • Ayrıştırıcı yerel dosyadan yüklenemezse araç hata gösterir ve indirme kapalı kalır.

Kaynaklar ve doğrulama

Ayrıştırma, ISC lisanslı yaml 2.9.1 kütüphanesiyle ve YAML 1.2.2 çekirdek şemasıyla yapılır; JSON tarafında bu araca özgü sıkı bir tarayıcı kullanılır. Kütüphane, sürümü, lisansı ve güvenlik durumu 25 Ekim 2026 tarihinde incelenmiş ve sitede yerel dosya olarak tutulmaktadır. Dönüşümler, ayrıştırıcının kendi çıktısına dayanmayan, elle yazılmış beklenen JSON örnekleriyle sınanmıştır.

Sık sorulan sorular

YAML'daki yorumlar JSON'a geçer mi?

Hayır. JSON'da yorum yoktur, bu yüzden yorumlar ve YAML'a özgü biçimlendirme kaybolur. Araç yorum bulduğunda bunu bir uyarıyla bildirir.

Neden alias ve çapa desteklenmiyor?

Alias zincirleri küçük bir metni çok büyük bir veriye genişletebilir. İlk sürüm hiçbir alias genişletmediği için bu risk yoktur. Alias içeren dosyayı önce başka bir araçla açıp düz değerlere çevirmeniz gerekir.

on: neden true olmuyor?

YAML 1.2 çekirdek şeması on ve yes sözcüklerini metin sayar. Araç bu kurala uyar, bu yüzden GitHub Actions dosyalarındaki on anahtarı JSON'da metin olarak kalır.

Büyük sayılarım neden hata veriyor?

JSON yazılımlarının çoğu sayıları çift duyarlıklı değer olarak okur. 9007199254740991'den büyük tam sayılar veya hassasiyeti bozulacak ondalıklar sessizce yuvarlanabilir; bu aracın sessiz veri kaybı yerine hata vermesi bilinçli bir tercihtir. Uzun kimlikleri metin olarak yazın.

Yapılandırmam sunucuya gidiyor mu?

Hayır. Dönüşüm tarayıcınızda çalışır ve metin sunucuya, depolamaya ya da paylaşım bağlantısına eklenmez. Yine de gerçek parola ve anahtarların yerine yer tutucu kullanmanızı öneririm.

Yayın: · Güncelleme: