JSON verisi Markdown tablosuna nasıl dönüştürülür?

Veriyi ve beklenen tablo yapısını hazırlama

Bu araç, JSON veya CSV biçimindeki metni Markdown tablo metnine çevirmek için kullanılır. Dokümantasyon, README dosyası ya da teknik not hazırlarken veriyi elle satır ve sütunlara ayırmak yerine metin girdisini düzenleyebilirsiniz. Sonuç başarılı olduğunda biçimlendirilmiş Markdown tablo metni elde edilir.

JSON ile çalışırken verinin beklenen satır benzeri yapıyı sağlaması gerekir. Dolu bir JSON nesnesi tek tablo satırı olarak değerlendirilir. Uygun yapıdaki JSON verisinde özel başlık girilmezse başlıklar ilk satırın anahtarlarından alınır. Boş liste, boş nesne, null, false, 0 veya boş metin gibi boş JSON değerleri dolu veri satırları yerine boş tablo sonucu oluşturur.

CSV için özel başlık verilmediğinde ilk satır başlık, sonraki satırlar veri olarak kullanılır. Böylece başlıkların otomatik alınmasını veya kendi başlıklarınızı belirlemeyi seçebilirsiniz. Girdiyi hazırlarken kullanılan biçim ile seçtiğiniz seçenek aynı olmalıdır; aksi durumda sonuç yerine başarısız işlem görebilirsiniz.

Dönüştürme seçeneklerini uygulama

1. Veri alanına JSON ya da CSV metnini girin. Alanı boş bırakmayın; hiç veri gönderilmediğinde işlem başarısız olur. JSON metninin sözdizimini, CSV metninin ise satır ve virgül ayrımlarını işlemden önce gözden geçirin.

2. Girdi biçimi olarak json veya csv seçin. JSON kullanıyorsanız geçerli ve beklenen satır yapısına sahip bir içerik sağlayın. Geçerli görünen fakat beklenen yapıyı sunmayan bazı JSON biçimleri de işleme sırasında başarısız olabilir.

3. İsterseniz özel başlık alanına başlıkları virgülle ayırarak yazın. Her başlığın başındaki ve sonundaki boşluklar kaldırılır. Bu alanı boş bırakırsanız JSON için uygun ilk satırın anahtarları, CSV için ilk satırdaki alanlar başlık olarak değerlendirilir.

4. Hizalama seçeneğinde left, center veya right değerlerinden birini kullanın. Bir seçim yapılmadığında sol hizalama varsayılandır. Desteklenmeyen başka bir değer girilirse ayraç işaretleri sol hizalamaya döner.

5. İşlemi başlatın ve oluşan Markdown metnini kontrol edin. Başlık satırını, ayraç satırını ve veri satırlarını birlikte inceleyerek girişteki alanların beklediğiniz düzende görünüp görünmediğini değerlendirin. Başarılı sonuç, Markdown tablo işaretleri içeren metin biçimindedir.

Oluşan Markdown metnini değerlendirme

Sonuçta başlık satırı, Markdown ayraç satırı ve veri satırları bulunuyorsa dönüşüm başarılı olmuş olabilir. JSON girdisinde özel başlık kullanılmadığında başlıkların ilk uygun satırdaki anahtarlardan gelmesi beklenir. CSV girdisinde ilk satır başlık görevi görür; sonraki satırlar tablo verisini oluşturur.

Hizalama, Markdown ayraç satırındaki işaretlerden okunur. center seçimi ortalamayı, right seçimi sağa hizalamayı, left seçimi ise sola hizalamayı ifade eder. Tanınmayan bir değer kullanıldığında sonuçta sol hizalamaya karşılık gelen işaretlerin görülmesi beklenir; bu durum verinin yeniden düzenlendiği anlamına gelmez.

Boş JSON değerlerinde veri satırları beklemeyin; araç bunları boş tablo sonucu olarak ele alır. Bozuk JSON başarısız sonuç verir ve bazı geçerli JSON yapıları da beklenen satır biçimini sunmadığında işlenemez. CSV içeriği satır ve virgül karakterlerine göre doğrudan ayrılır. Bu nedenle tırnak içindeki virgüller gibi gelişmiş CSV kuralları doğrulanmış değildir. Başlık sayısından fazla alan atılabilir, eksik alanlar ise boş kalabilir. Sonucu kullanmadan önce özellikle bu iki durumu girişinizle karşılaştırın.

Uygulamalı örnek

Bir ekip, iki kişinin puanlarını dokümantasyonda Markdown tablosu olarak göstermek için JSON verisini dönüştürürse başlıkları ve hizalama işaretlerini aynı sonuçta inceleyebilir.

[{"ad":"Ayşe","puan":92},{"ad":"Mehmet","puan":85}] JSON metnini veri alanına girin, json biçimini seçin, özel başlık olarak İsim, Puan yazın ve center hizalamasıyla işlemi başlatın. Sonuçta iki başlığın, iki kişinin ve ortalama ayraç işaretlerinin bulunduğu Markdown metnini arayın.

İsim ve Puan başlıklarını içeren bir Markdown başlık satırı, ortalamayı gösteren bir ayraç satırı ve Ayşe ile Mehmet'in puanlarını taşıyan iki veri satırı oluşması beklenir.

Sınırlamalar

• CSV içeriği satır ve virgül karakterlerine göre ayrıldığı için tırnak içindeki ayraçlar gibi gelişmiş kurallar doğrulanmış değildir; fazla alanlar atılabilir ve eksik alanlar boş kalabilir.

Sık yapılan hatalar

• Boş veri, desteklenmeyen bir biçim seçimi veya bozuk JSON başarısız işleme yol açabilir. Veri alanını doldurun, biçim olarak json ya da csv seçin ve JSON sözdizimini yeniden denetleyin.

Sık sorulan sorular

Her JSON verisi Markdown tablosuna dönüşür mü?

Yalnızca beklenen satır yapısını sağlayan ve sözdizimi bozulmamış JSON başarılı biçimde tabloya dönüşebilir. Bazı geçerli fakat uygun olmayan yapılar ile hatalı JSON işleme sırasında başarısız olur; içeriği ve yapıyı yeniden kontrol edin.

CSV başlıklarını kendim belirleyebilir miyim?

CSV başlıkları, özel başlık alanına virgülle ayrılmış metin yazılarak belirlenebilir. Bu alan kullanılmazsa ilk satır başlık kabul edilir; özel başlıklardaki çevre boşlukları kaldırılır ve değerler başlık olarak kullanılır.

Tablo sütunlarını ortalayabilir miyim?

center seçeneği tablo ayraçlarını ortalanmış düzen için üretir. left ve right de desteklenir; desteklenmeyen bir değer girilirse ayraç işaretleri sol hizalama seçeneğine geri döner, bu yüzden değeri seçeneklerden biriyle yazın.