Ne işe yarar
Markdown tablolarını elle yazmak zahmetlidir: her satır dikey çizgi, ikinci satır tire ister ve sütunları elle hizalamak çok uzun sürer. Bu araç CSV veya TSV verisini, README’ye, pull request’e, issue’ya, wiki sayfasına ya da Markdown kullanan herhangi bir belgeye yapıştırabileceğiniz bir GitHub Flavored Markdown tablosuna dönüştürür.
CSV doğru ayrıştırılır; virgül içeren tırnaklı alanlar, çift yazılmış tırnaklar ve çok satırlı hücreler işlenir. Çıktı boşluklarla doldurularak sütunlar düz metinde de hizalanır; bu da tabloyu sonradan okumayı ve düzenlemeyi kolaylaştırır.
Nasıl kullanılır
- CSV veya TSV yapıştırın, bir
.csvya da.tsvdosyası yükleyin veya Örnek’e tıklayın. - Hizalama’yı seçin: varsayılan, sola, ortaya, sağa veya yalnızca sayı içeren sütunları sağa yaslamak için Sayılar sağa.
- İlk satır sütun adlarını içeriyorsa İlk satır başlık açık kalsın; aksi hâlde başlık Column 1, Column 2 vb. olur.
- Doldurmasız, sıkı satırlar istiyorsanız Sütunları hizala’yı kapatın.
- Tabloyu kopyalayın ya da
.mddosyası olarak indirin.
Başlıktan daha az hücresi olan satırlar boş hücrelerle tamamlanır, bu yüzden tablo her zaman geçerlidir.
Örnek
Şu CSV:
Tool,Stars,Notes
ripgrep,48000,"Fast, recursive search"
fd,34000,find | but friendlier
Sayılar sağa hizalamasıyla şu Markdown tablosuna dönüşür:
| Tool | Stars | Notes |
| ------- | ----: | ---------------------- |
| ripgrep | 48000 | Fast, recursive search |
| fd | 34000 | find \| but friendlier |
Tırnaklı alandaki virgül hücrede kalır, dikey çizgi kaçışlanır ve sayı sütunu görüntülendiğinde sağa yaslanması için --: işaretini alır.
İpuçları
- İkinci satırdaki hizalama işaretleri (
:--,:-:,--:) görüntülenen tabloda her sütunun nasıl hizalanacağını belirler. - Hücrelerdeki
**kalın**, satır içi kod veya bağlantılar gibi satır içi Markdown korunur ve çoğu görüntüleyicide işlenir. - Çok geniş tablolar küçük ekranlarda zor okunur; sütunları birkaç tabloya bölmeyi düşünün.
- Bunun yerine HTML tablosu oluşturmak ya da bir JSON dizisini Markdown tablosuna çevirmek için aşağıdaki ilgili araçları kullanın.
SSS
› Tablo hangi Markdown türünü kullanıyor?
GitHub Flavored Markdown (GFM) dikey çizgili tabloları. GitLab, Bitbucket, Notion, Obsidian, Docusaurus, MkDocs ve çoğu statik site oluşturucu da bunları destekler. Saf CommonMark’ta tablo sözdizimi yoktur.
› Hücrelerdeki dikey çizgiler ve satır sonları ne olur?
Dikey çizgi hücreyi bitireceği için \| olarak yazılır. Tablo satırı içinde satır sonuna izin verilmez; bu yüzden satır sonları <br> etiketine dönüşür, GitHub ve çoğu görüntüleyici bunu satır sonu olarak gösterir.
› Çince, Japonca veya Korece sütunlar neden hizalı görünüyor?
Sütunları hizala açıkken hücreler görüntüleme genişliğine göre doldurulur: geniş Doğu Asya karakterleri iki sütun sayılır, böylece ham Markdown eş aralıklı yazı tipli bir düzenleyicide hizalı kalır. Görüntülenen tablo her iki durumda da aynıdır.
› Excel veya Google E-Tablolar’dan kopyalanan TSV’yi dönüştürebilir miyim?
Evet. Bir elektronik tablodan kopyalanan hücreler sekmeyle ayrılır ve ayırıcı otomatik algılanır. Sekmeyi açıkça da seçebilirsiniz.