Başlangıç Yayın: 17 Temmuz 2026 7 dk okuma

Markdown Nedir, Nasıl Yazılır? Başlangıçtan ileri seviyeye tam rehber

"Markdown öğren" demek, aslında bir avuç işareti ezberlemek demektir. Bu rehberde Markdown'ın ne olduğunu, neden bu kadar yaygınlaştığını ve başlıktan görev listesine kadar tüm temel sözdizimini gerçek örneklerle, adım adım öğreniyorsunuz — hiçbir ön bilgiye ihtiyacınız yok.

İçindekiler

Markdown nedir? (kısa cevap)
Başlık nasıl yazılır?
Kalın, italik ve üstü çizili metin
Liste ve görev listesi
Kod, bağlantı ve görsel
Tüm sözdizimi tek tabloda
Sık sorulan sorular

Markdown nedir?

Kısa cevap Markdown, düz metne #, *, - gibi basit işaretler ekleyerek başlık, kalın, italik, liste ve bağlantı gibi biçimlendirmeler yapmanızı sağlayan hafif bir işaretleme dilidir. 2004'te John Gruber tarafından tasarlanmıştır; amaç, yazının hem okunabilir düz metin hem de otomatik olarak geçerli HTML'e çevrilebilir olmasıdır.

Markdown bugün GitHub README dosyalarından blog yazılarına, Slack mesajlarından teknik dokümantasyona kadar hemen her yerde karşınıza çıkar. Popülerliğinin sebebi basit: hiçbir özel programa ihtiyaç duymadan, herhangi bir metin dosyasında yazılabilir ve .md uzantısıyla kaydedilir. Yazdığınız markdown'ı anında HTML olarak görmek isterseniz Markdown Önizleme aracını kullanabilirsiniz — sağ panelde biçimlendirilmiş sonucu canlı görürsünüz.

Markdown'da başlık nasıl yazılır?

Kısa cevap Satır başına # işareti koyarak başlık oluşturursunuz. Bir # en büyük başlığı (H1), iki ## alt başlığı (H2) verir; bu şekilde ######'a (H6) kadar altı seviye kullanılabilir. # ile metin arasına mutlaka bir boşluk konmalıdır.

Örneğin # Proje Adı yazdığınızda büyük bir ana başlık, ## Kurulum yazdığınızda ondan daha küçük bir alt başlık oluşur. Başlık seviyeleri, bir dokümanın hiyerarşisini (ana konu → alt konu → detay) düz metin içinde göstermenin en pratik yoludur ve bu araç gibi önizleyiciler bu hiyerarşiden otomatik bir içindekiler tablosu bile üretebilir.

Kalın, italik ve üstü çizili metin nasıl yazılır?

Kısa cevap Kalın için metni **iki yıldız** veya __çift alt çizgi__ arasına, italik için *tek yıldız* veya _tek alt çizgi_ arasına alın. İkisini birlikte istiyorsanız ***üç yıldız*** kullanın. GitHub Flavored Markdown'da üstü çizili metin için ~~çift tilde~~ eklenir.

Vurgu işaretleri kelimenin bitişiğinde olmalıdır; ** kalın ** gibi araya boşluk koyarsanız bazı işlemciler bunu biçimlendirmez. Bu küçük ayrıntı, yeni başlayanların en sık düştüğü hatadır — bu yüzden yazdıktan sonra bir önizleyicide kontrol etmek her zaman iyi bir alışkanlıktır.

Neden iki farklı işaret var (yıldız ve alt çizgi)? Orijinal Markdown tanımı ikisini de eşdeğer kabul eder; ancak çoğu yazar tutarlılık için kalın/italik'te yıldız, kelime içi vurgudan kaçınmak gerektiğinde alt çizgi kullanmayı tercih eder (ör. bir_degisken_adi yanlışlıkla italik yapılmaz).

Markdown'da liste ve görev listesi nasıl yazılır?

Kısa cevap Sırasız liste için satır başına -, * veya + koyun. Sıralı liste için 1., 2. gibi sayılar kullanın — numaraların doğru sırada olması çoğu işlemci için şart değildir, otomatik yeniden numaralandırılır. Görev listesi (GFM) için - [ ] yapılacak ve tamamlanan görevler için - [x] bitti yazılır.

İç içe liste yapmak için alt maddeleri iki veya dört boşlukla girintilemeniz yeterlidir. Görev listeleri özellikle GitHub issue'larında ve proje planlarında çok kullanılır; bu araçta önizlemedeki kutuyu tıklayarak durumunu değiştirebilir ve güncellenen markdown kaynağını anında görebilirsiniz.

Sırasız liste: - Elma, - Armut
Sıralı liste: 1. Kayıt ol, 2. Giriş yap
Görev listesi: - [x] Tasarım, - [ ] Test

Bu örnekleri şimdi deneyin

Yazdığınız her satırın nasıl göründüğünü anında görmek en hızlı öğrenme yoludur. Aşağıdaki örnekleri kopyalayıp editöre yapıştırın, sonucu canlı izleyin.

Markdown Önizleyiciyi Aç →

Kod, bağlantı ve görsel nasıl eklenir?

Kısa cevap Satır içi kod için metni `tek ters tırnak` arasına alın. Çok satırlı kod bloğu için üç ters tırnak (```) ile açıp kapatın; isteğe bağlı olarak dil adını (ör. ```python) ekleyerek sözdizimi vurgusu alabilirsiniz. Bağlantı için [görünen metin](url), görsel için başına ünlem işareti eklenmiş ![alt metin](url) yazılır.

Bağlantı ve görsel sözdizimi neredeyse aynıdır; tek fark görselin başındaki ! işaretidir. Bu küçük detay çok karıştırılır: [Google](https://google.com) tıklanabilir bir bağlantı oluştururken, başına ! eklerseniz tarayıcı "Google" metnini alt metin olarak kullanan bir görsel yerleştirmeye çalışır.

Alıntı ve yatay çizgi

Blok alıntı için satır başına > işareti konur; iç içe alıntı için >> kullanılır. Bir bölümü ayırmak için satıra yalnızca ---, *** veya ___ yazarak yatay çizgi (kesme çizgisi) eklenir.

Tüm temel sözdizimi tek tabloda

Aşağıdaki tablo, bu rehberde geçen tüm öğeleri hızlı başvuru için bir araya getirir. Kaydedip ihtiyaç duydukça bakabilirsiniz.

Markdown temel sözdizimi — hızlı başvuru
Öğe	Yazım	Sonuç
Başlık	`# Metin`	H1 başlık
Kalın	`metin`	metin
İtalik	`metin`	metin
Üstü çizili	`~~metin~~`	~~metin~~
Satır içi kod	`kod`	`kod`
Sırasız liste	`- madde`	• madde
Görev listesi	`- [x] iş`	☑ iş
Bağlantı	`[metin](url)`	tıklanabilir bağlantı
Görsel	`![alt](url)`	gömülü görsel
Alıntı	`> metin`	girintili alıntı bloğu
Yatay çizgi	`---`	ayraç çizgisi

Kaynak: CommonMark Spesifikasyonu (üstü çizili ve görev listesi GFM ekidir).

Benzersiz içgörü Çoğu yeni başlayan Markdown'ı bir "editör özelliği" sanır; oysa Markdown yalnızca bir sözdizimi standardıdır — Not Defteri'nde bile geçerlidir. Gerçek fark, yazdığınız metni kimin render ettiğidir: GitHub, bir blog motoru veya bu sayfadaki gibi bir önizleyici. Aynı .md dosyası farklı platformlarda ufak farklarla (özellikle GFM eklerinde) görünebilir; bu yüzden yayınlamadan önce hedef platforma yakın bir önizleyicide kontrol etmek önemlidir.

Markdown'ın tablo desteği ayrı ve biraz daha ayrıntılı bir konudur; başlık satırı, ayraç satırı ve hizalama kurallarını "Markdown ile Tablo Nasıl Oluşturulur?" rehberinde adım adım anlatıyoruz. GitHub'a özel README yazma teknikleri için ise "GitHub README İçin Markdown İpuçları" yazımıza göz atabilirsiniz.

Sık sorulan sorular

Markdown nedir?

Düz metne basit işaretler ekleyerek başlık, kalın, italik, liste ve bağlantı gibi biçimlendirmeler yapmanızı sağlayan hafif bir işaretleme dilidir. 2004'te John Gruber tarafından tasarlanmıştır ve otomatik olarak HTML'e çevrilebilir.

Markdown nasıl yazılır?

Herhangi bir düz metin editöründe yazılır ve .md uzantısıyla kaydedilir. Başlık için #, kalın için **metin**, italik için *metin*, liste için -, bağlantı için [metin](url) kullanılır. Özel bir program gerekmez.

Markdown dosyası nasıl açılır?

Bir .md dosyası herhangi bir metin editöründe düz metin olarak açılabilir. Biçimlendirilmiş halini görmek için GitHub gibi platformlar otomatik render eder, ya da içeriği bu sayfadaki gibi bir markdown önizleyiciye yapıştırabilirsiniz.

Markdown ile HTML arasındaki fark nedir?

HTML etiket tabanlı ve ayrıntılıdır; Markdown ise düz metne yakın, hızlı yazılan bir kısayoldur. Markdown'ı yazıp bir dönüştürücüyle geçerli HTML'e çevirebilirsiniz — kaynak Markdown, çıktı HTML'dir.

Markdown'da yeni satır ve paragraf nasıl yapılır?

Yeni bir paragraf için satırlar arasına boş bir satır bırakılır. Aynı paragraf içinde tek Enter çoğu zaman görmezden gelinir; zorla satır sonu için satırın sonuna iki boşluk bırakılır.

Markdown öğrenmek ne kadar sürer?

Temel sözdizimi (başlık, kalın, italik, liste, bağlantı, kod) 10-15 dakikada öğrenilebilir; bunlar günlük kullanımın yaklaşık %90'ını kapsar. Tablo ve görev listesi gibi GFM ekleriyle birlikte tam hakimiyet için yarım saat yeterlidir.

İlgili rehberler

Metodoloji & kaynaklar. Bu rehberdeki tüm örnekler, MarkdownÖnizle'nin kendi açık önizleme motorunda test edilerek doğrulanmıştır. Sözdizimi kuralları CommonMark Spesifikasyonu'na, üstü çizili metin ve görev listesi gibi ekler GitHub Flavored Markdown (GFM) Spesifikasyonu'na dayanır. Son güncelleme: 17 Temmuz 2026. Platforma özgü küçük davranış farkları (ör. otomatik bağlantı algılama) olabilir; kritik kullanımlarda hedef platformda test etmeniz önerilir.