Tablo Yayın: 17 Temmuz 2026 6 dk okuma

Markdown ile Tablo Nasıl Oluşturulur? GFM sözdizimi ve hizalama rehberi

Markdown tablosu üç satırdan ibarettir: başlık, ayraç ve veri. Ama o ayraç satırındaki küçük bir eksik tire veya yanlış konmuş iki nokta, tüm tabloyu ham metin olarak bırakabilir. Bu rehberde GFM tablosunu sıfırdan doğru kurmayı, sol/orta/sağ hizalamayı ve en sık yapılan hataları gerçek örneklerle öğreniyorsunuz.

İçindekiler

Markdown tablosu nedir? (kısa cevap)
Temel tablo nasıl kurulur?
Sol, orta ve sağ hizalama
Sık yapılan hatalar
Kopyala-yapıştır hazır şablon
Sık sorulan sorular

Markdown tablosu nedir?

Kısa cevap Markdown tablosu, sütunları dikey çizgi (|) ile ayrılmış bir başlık satırı, altında en az üç tireden oluşan bir ayraç (separator) satırı ve onu izleyen veri satırlarından oluşan bir GFM (GitHub Flavored Markdown) eklentisidir. Orijinal Markdown tanımında yoktur; tablo desteği yalnızca GFM ve onu destekleyen işlemcilerde çalışır.

Bu üç parça — başlık, ayraç, veri — bir arada tabloyu oluşturur. Ayraç satırı en kritik parçadır: o satır olmadan işlemci diğer satırları tablo değil, düz metin olarak render eder. Yazdığınız tabloyu anında görmek isterseniz Markdown Önizleme aracına yapıştırıp sağ panelde canlı sonucu kontrol edebilirsiniz.

Temel bir markdown tablosu nasıl kurulur?

Kısa cevap Önce sütun adlarını | ile ayırarak bir satıra yazın. Altına, sütun sayısı kadar en az üçer tireden oluşan bir ayraç satırı (| --- | --- |) ekleyin. Sonra veri satırlarını aynı | formatında alt alta sıralayın. Satır başı ve sonundaki dikey çizgiler isteğe bağlıdır ama okunabilirlik için önerilir.

Yazdığınız markdown

| Ürün    | Fiyat  | Stok |
| ------- | ------ | ---- |
| Kalem   | 12 TL  | 40   |
| Defter  | 35 TL  | 18   |
| Silgi   | 8 TL   | 0    |

Yukarıdaki üç satırlık kaynak, aşağıdaki gibi gerçek bir HTML tablosuna dönüşür:

Ürün	Fiyat	Stok
Kalem	12 TL	40
Defter	35 TL	18
Silgi	8 TL	0

Dikkat edilmesi gereken tek kural: ayraç satırındaki tire sayısı sütun sayısıyla eşleşmeli ve her sütun için en az bir tire olmalıdır. Hücrelerdeki boşluklar (hizalama için eklediğiniz fazladan boşluklar dahil) render sırasında önemsizdir — işlemci onları otomatik olarak siler.

Neden dikey çizgileri hizalamak zorunlu değil? Kaynak markdown'da | işaretlerini alt alta hizalamak yalnızca okunabilirlik içindir; işlemci boşlukları görmezden gelir. Yani |Kalem|12 TL|40| ile boşluklu hali aynı sonucu üretir — ama takım halinde çalışıyorsanız hizalı yazmak diff'leri okumayı kolaylaştırır.

Bu tabloyu şimdi deneyin

Yukarıdaki örneği kopyalayıp editöre yapıştırın, kendi verilerinizle değiştirin ve sonucu anında görün.

Markdown Önizleyiciyi Aç →

Sol, orta ve sağ hizalama nasıl yapılır?

Kısa cevap Hizalama, ayraç satırındaki tirelere iki nokta (:) ekleyerek belirlenir: :--- sola, :---: ortaya, ---: sağa hizalar. İki nokta eklenmezse varsayılan olarak sol hizalama uygulanır — bu yüzden çoğu tabloda hizalama işareti hiç görünmez.

Hizalamalı örnek

| Sol      | Orta     | Sağ      |
| :------- | :------: | -------: |
| elma     | armut    | çilek    |
| 1        | 22       | 333      |

Yukarıdaki kaynağın render edilmiş hali
Sol	Orta	Sağ
elma	armut	çilek
1	22	333

Hizalama, özellikle sayısal sütunlarda (fiyat, miktar, tarih) okunabilirliği artırır — sağa hizalanmış rakamlar göz için karşılaştırması çok daha kolaydır. Metinsel sütunlarda ise genelde sol hizalama (varsayılan) yeterlidir ve fazladan işaret eklemeye gerek kalmaz.

Sütun genişliği kontrol edilebilir mi?

Hayır — GFM tablo sözdiziminde sütun genişliğini piksel veya yüzde olarak belirlemenin bir yolu yoktur; tire sayısını uzatmak (ör. --------) sadece kaynağı okunaklı yapar, render edilen genişliği değiştirmez. Genişlik tamamen o platformun CSS'ine bağlıdır. Kesin bir genişlik gerekiyorsa ham HTML <table> etiketi kullanmanız gerekir; markdown tabloları ham HTML'e izin verdiği için bu genellikle mümkündür.

Sık yapılan hatalar

Aşağıdaki tablo, yeni başlayanların markdown tablosunda en sık düştüğü hataları ve doğru kullanımı özetler.

Sık yapılan tablo hataları — hızlı başvuru
Hata	Sonuç	Doğrusu
Ayraç satırı unutulur	Tablo render edilmez, düz metin kalır	`\| --- \| --- \|` satırını mutlaka ekleyin
Ayraçta tek tire (`-`)	Bazı işlemciler kabul etmez	En az üç tire kullanın: `---`
Hücrede kaçışsız `\|`	İstenmeyen sütun açılır	Kaçış yapın: `\\|`
Hücre içinde gerçek satır sonu	Tablo yapısı bozulur	`<br>` HTML etiketi kullanın
Başlık ile veri sütun sayısı uyuşmaz	Eksik hücreler boş kalır, fazlalar kırpılır	Her satırda aynı sayıda `\|` bulundurun

Kaynak: GitHub Flavored Markdown (GFM) Spesifikasyonu, Tablo (Extension) bölümü.

Benzersiz içgörü Markdown tablosu aslında bir tam tabloyu değil, sadece basit veri gridlerini hedefler. Birleştirilmiş hücre (colspan/rowspan), iç içe tablo veya karmaşık kenarlık stilleri GFM sözdizimiyle mümkün değildir — bunlar için doğrudan HTML <table> yazmak gerekir. Bu sınırlama bilinçlidir: markdown'ın felsefesi "düz metin bile okunaklı kalsın" ilkesine dayanır, bu yüzden çok karmaşık tablo ihtiyaçlarında markdown yanlış araçtır.

Kopyala-yapıştır hazır şablon

Aşağıdaki iskeleti kopyalayıp sütun adlarını ve verileri kendinize göre değiştirebilirsiniz — dört sütunlu, sol hizalı, minimum yapı içerir.

Hazır şablon (4 sütun)

| Başlık 1 | Başlık 2 | Başlık 3 | Başlık 4 |
| -------- | -------- | -------- | -------- |
|          |          |          |          |
|          |          |          |          |

Markdown tablosunun temelini öğrendiyseniz, sıradaki adım genel sözdizimini pekiştirmektir — başlık, liste, kod ve bağlantı gibi diğer temel öğeleri "Markdown Nedir, Nasıl Yazılır?" rehberinde bulabilirsiniz. Tabloyu bir GitHub README'sinde kullanacaksanız "GitHub README İçin Markdown İpuçları" yazımız rozet ve katlanabilir bölümlerle nasıl bir araya getirileceğini gösteriyor.

Sık sorulan sorular

Markdown ile tablo nasıl yapılır?

Sütun adlarını dikey çizgi (|) ile ayırarak bir başlık satırı yazın, altına en az üç tireden oluşan bir ayraç satırı (| --- | --- |) ekleyin, sonra veri satırlarını aynı formatta alt alta sıralayın. Bu üç parça GFM tablosunun tamamıdır.

Markdown tabloda hizalama nasıl yapılır?

Ayraç satırındaki tireye iki nokta ekleyerek hizalama belirlenir: :--- sola, :---: ortaya, ---: sağa hizalar. İki nokta yoksa varsayılan olarak sol hizalama uygulanır.

Markdown tabloda hücre içinde satır sonu olur mu?

Standart GFM tablosunda bir hücre tek satırdan oluşmak zorundadır; gerçek bir satır sonu tabloyu bozar. Hücre içinde görsel satır sonu için <br> HTML etiketi kullanılabilir, çünkü markdown tabloları ham HTML'e izin verir.

Tablo hücresinde dikey çizgi (|) nasıl yazılır?

Hücre içeriğinde gerçek bir | karakteri kullanmak isterseniz, onu ters eğik çizgiyle kaçış yapmanız gerekir: \|. Aksi halde işlemci onu yeni bir sütun sınırı sanır.

Markdown tablo desteklenmiyor mu, hangi platformlar destekler?

Tablo, orijinal Markdown tanımında yoktur; GitHub Flavored Markdown (GFM) ekiyle gelmiştir. GitHub, GitLab, birçok statik site üreticisi ve bu sitedeki önizleyici GFM tablosunu destekler; ancak çok temel bazı işlemciler tabloyu render etmeyebilir.

İlgili rehberler

Metodoloji & kaynaklar. Bu rehberdeki tüm tablo örnekleri, MarkdownÖnizle'nin kendi açık önizleme motorunda test edilerek doğrulanmıştır. Sözdizimi kuralları GitHub Flavored Markdown (GFM) Spesifikasyonu'nun Tablo (Extension) bölümüne dayanır. Son güncelleme: 17 Temmuz 2026. Platforma özgü küçük davranış farkları (ör. eksik hücre doldurma) olabilir; kritik kullanımlarda hedef platformda test etmeniz önerilir.