Markdown Tablo Oluşturucu

Markdown tabloları oldukça titizdir: tek bir dik çizgi eksikse ya da ayırıcı satır düzensizse tüm tablo düz metin olarak görünür. Bu oluşturucu, içine yazabileceğiniz görsel bir ızgara sunar; elektronik tablodan CSV veya TSV yapıştırmanıza olanak tanır ve sütunların kaynakta hizalandığı bir Markdown tablosu üretir; böylece tabloyu diff içinde okumak çok daha kolay olur ve ilk denemede doğru yaparsınız.

Bir Markdown tablosu nasıl oluştururuz?

  1. 1

    Satırları ve sütunları seçin

    Ya da bir CSV/TSV dosyasını yapıştırın; araç boyutları otomatik olarak belirler.

  2. 2

    Hücre içeriğini girin

    Her hücreye tıklayın. Tab ve ok tuşları bir elektronik tablo gibi kullanılır.

  3. 3

    Sütun hizalamasını ayarlayın

    Başlık satırı aracılığıyla her sütun için sola (varsayılan), ortaya veya sağa.

  4. 4

    Markdown çıktısını kopyalayın

    Araç, kaynağın düzenli görünmesi için dik çizgileri sütun genişliğine kadar doldurur.

Markdown tablo sözdizimi

Temel tablo:

| Sütun A  | Sütun B  | Sütun C  |
|----------|----------|----------|
| hücre 1  | hücre 2  | hücre 3  |
| hücre 4  | hücre 5  | hücre 6  |

Hizalama, ayırıcı satırda iki nokta üst üste kullanır:

| Sol | Orta | Sağ |
|:----|:----:|----:|
| a   | b    | c   |
  • :--- sola hizalama
  • :---: ortala
  • ---: sağa hizalama

Oluşturucunun sizin için yaptıkları

  • Her hücreyi sütundaki en uzun girişin genişliği kadar doldurur; böylece dik çizgiler kaynakta hizalanır. Bu işlem işlenmiş çıktıyı etkilemez (Markdown fazladan boşlukları yok sayar), ancak diff’i okuyanlar size minnettar olur.
  • \|, hücrelerin içindeki dik çizgileri kaçış karakteriyle yazar; bu sayede a|b içeren bir hücre iki sütuna bölünmez.
  • Hizalamayı korur: sütun genişliklerini değiştirdiğinizde hizalama bozulmaz.
  • CSV ve TSV yapıştırmayı kabul eder; tırnak içindeki alanları ve tırnak içindeki virgülleri algılar.

Sık yapılan hatalar

  • Ayırıcı satır zorunludur. |---|---| satırı olmayan Markdown tabloları düz metin olarak görüntülenir.
  • Çok satırlı hücreler olmaz. Her satır tek bir satırdır; içeride satır kesmesi gerekiyorsa <br> ekleyin, çünkü tablo hücrelerinde Markdown’un satır kesmeleri desteklenmez.
  • İç içe tablo olmaz. Gerekiyorsa HTML’e geçin.
  • Boş hücreler için bir boşluk (veya en azından boş bir dik çizgi çifti) gerekir. Doğrudan || kullanmaktan kaçının.

HTML’yi ne zaman tercih etmeli

colspan, rowspan, çok satırlı hücreler veya özel CSS sınıflarına ihtiyacınız varsa doğru araç HTML tablolarıdır. Çoğu Markdown ayrıştırıcısı ham HTML tablo işaretlemesini doğrudan metin içinde (inline) kabul eder.

Markdown tablolarının iyi işlediği yerler

  • GitHub, GitLab ve Gitea’daki README dosyaları.
  • Issue ve pull request (PR) açıklamaları.
  • Obsidian, Bear ve çoğu not alma uygulaması.
  • Docusaurus, MkDocs ve Hugo, hepsi GFM tablolarını destekler.

Sık Sorulan Sorular

Doğrudan değil. Satır içi satır kesmeleri için <br> kullanın. Gerçek çok satırlı içerik için (kod blokları, hücre içindeki listeler) HTML <table> öğesine geçin.

GFM birleştirilmiş hücreleri desteklememektedir. colspan veya rowspan kullanmanız gerekiyorsa Markdown belgenizde HTML kullanın; çoğu renderör <table>’yi değişiklik yapılmadan geçer.

Hayır. Oluşturulan HTML, dolgu eklense de eklenmese de aynıdır; dolgu yalnızca kaynağın okunabilirliği için bir tercihtir.

Evet. Bir elektronik tablodan kopyalamak, verileri panoya TSV (sekmeyle ayrılmış değerler) biçiminde koyar. Oluşturucu TSV’yi algılar ve aynı satır ve sütunlara sahip bir Markdown tablosu oluşturur.

\| yazın. Çoğu ayrıştırıcı bunu, sütun sınırını bozmadan birebir bir dik çizgi olarak görüntüler.

İlgili Araçlar

Araç diğer dillerde mevcuttur