CSV'den Markdown Tablosuna

Nasıl çalışır?

İlk satır tablonun başlığı kabul edilir; hemen altına Markdown'ın hizalama satırı eklenir ve kalan satırlar veri olur. Ayırıcı otomatik seçildiğinde noktalı virgül, virgül, sekme ve dikey çizgi adayları tırnak dışında sayılır, sonra satırdan satıra aynı sayıda sütun üreten aday seçilir — böylece bir adres alanının içindeki virgül ayırıcı sanılmaz. Satır sonunun üç biçimi de tanınır: Windows'un CR+LF'i, Mac ve Linux'un LF'i ve çok eski programların yalnız CR'si; yalnız CR kullanan bir dosya birçok araçta tek satır gibi görünür. Hücrelerdeki dikey çizgi karakteri ters bölü ile kaçırılır, çünkü Markdown'da o karakter sütunu böler. Tırnak içine alınmış çok satırlı bir hücrenin satır sonu <br> etiketine çevrilir; Markdown tablosunda bir hücre tek satıra sığmak zorundadır. Çıktıdaki hücreler sütun genişliğine göre boşlukla doldurulur, yani tablo işlenmeden önce, düz metin halinde de okunabilir kalır.

Bu araç csv to markdown, readme tablo, markdown table generator aramalarıyla da biliniyor.

Markdown nedir?

Markdown, biçimlendirmeyi etiket yerine noktalama işaretleriyle anlatan hafif bir yazım dilidir: satır başındaki diyez başlık, yıldız arasındaki metin kalın, tire ile başlayan satır liste öğesi olur. Kaynak dosya işlenmeden de okunabildiği için yazılım depolarında, belgelerde ve not uygulamalarında standart haline gelmiştir. Dosya uzantısı .md'dir ve düz metin olduğu için sürüm takibiyle iyi çalışır.

Markdown tablosu nedir?

Markdown tablosu, hücreleri dikey çizgiyle ayrılmış satırlardan oluşur ve başlığın hemen altında tirelerden kurulu bir hizalama satırı taşır. Bu ikinci satır zorunludur: hem tablonun başladığını bildirir hem de sütunların sola, ortaya mı sağa mı yaslanacağını iki nokta işaretiyle söyler. Hücre içine tablo, liste veya satır sonu konamaz; taşınabilirliğin bedeli budur.

Hizalama satırı nedir?

Hizalama satırı, tablonun başlık satırının altındaki tirelerden oluşan satırdır ve her sütun için ayrı yazılır. İki nokta işaretinin yeri hizalamayı belirler: tirelerin solundaysa sütun sola, sağındaysa sağa, iki yanındaysa ortaya yaslanır; hiç yoksa işleyicinin varsayılanı geçerli olur. Bu satırdaki hücre sayısı başlıktakiyle aynı olmak zorundadır, yoksa tablo tablo olarak görünmez.

CSV ile Markdown tablosu arasındaki fark nedir?

CSV makinelerin okuması için tasarlandı: ayırıcı karakter dışında hiçbir süs yoktur, sütun genişliği ve hizalama diye kavramlar taşımaz. Markdown tablosu ise insanın okuması için tasarlandı; hizalama bilgisi taşır ve kaynak halinde bile tablo gibi görünür. Buna karşılık Markdown tablosunu veritabanına aktaramazsınız. Bu araç CSV'yi yayına hazır bir tabloya çevirir; ters yön için tabloyu yeniden veri haline getirmeniz gerekir.

Hizalamayı neye göre seçmeli?

Markdown'da hizalama, başlığın altındaki çizgi satırındaki iki nokta ile belirtilir ve tablonun tamamı için geçerlidir. Bu araç tek bir hizalama uygular; sütun sütun farklı hizalama isterseniz çıktıdaki çizgi satırını elle düzenlemeniz yeterlidir.

Pratikte tutar, adet ve tarih içeren tablolarda sağa hizalama okumayı belirgin biçimde kolaylaştırır: rakamların basamakları alt alta gelir. Metin ağırlıklı tablolarda sola hizalama doğal duruştur.

• Sola — ad, açıklama, durum gibi metin sütunları
• Ortaya — kısa etiketler, işaretler, tek harfli kodlar
• Sağa — tutar, adet, yüzde, tarih

Çıktıyı nerede kullanabilirsiniz?

Markdown tabloları GitHub ve GitLab depolarında, README dosyalarında, wiki sayfalarında, statik site üreticilerinde ve pek çok not uygulamasında aynı şekilde işlenir.

Tabloyu bir belgeye yapıştırdıktan sonra da düzenleyebilirsiniz: satır eklemek için yeni bir satır yazıp aynı sayıda dikey çizgi koymanız yeterlidir. Boşlukla doldurulmuş sütunlar bozulsa bile tablo doğru işlenir; boşluklar yalnızca okunabilirlik içindir.

Verinizde nelere dikkat etmeli?

Başlık satırı zorunludur. Verinizde başlık yoksa en üste bir satır ekleyin, yoksa ilk kaydınız başlık olarak görünür.

Satırların sütun sayısı farklıysa en geniş satır esas alınır ve eksik hücreler boş bırakılır; böylece tablo bozulmaz. Boş bir hücre Markdown'da sorun çıkarmaz.

Sık sorulanlar

İlk satır mutlaka başlık mı olmalı?

Evet. Markdown tablosunun tanımı gereği bir başlık satırı ve onun altında hizalama satırı bulunur. Verinizde başlık yoksa en üste kendiniz bir satır ekleyin.

Hücremde dikey çizgi varsa ne oluyor?

Ters bölü ile kaçırılır ve tabloda karakter olarak görünür. Kaçırılmasaydı o karakter sütunu ikiye böler ve satır kayardı.

Çok satırlı hücreler destekleniyor mu?

Tırnak içindeki satır sonu <br> etiketine çevrilir, çünkü Markdown tablosunda bir hücre tek satıra sığmak zorundadır. Çoğu işleyici <br> etiketini satır sonu olarak gösterir.

Sütun sütun farklı hizalama yapabilir miyim?

Araç tek hizalama uygular. Farklı hizalama isterseniz çıktının ikinci satırındaki iki nokta işaretlerini elle taşımanız yeterli; tablonun kalanına dokunmanıza gerek yoktur.

Verim bir yere gönderiliyor mu?

Hayır. Ayrıştırma ve tablo üretimi tarayıcınızın içinde olur; yapıştırdığınız veri hiçbir sunucuya gitmez.