Markdown Kopya Kâğıdı: Örneklerle GitHub-Flavored Sözdizimi

Markdown, düz metin olarak da okunabilir kalan biçimlendirilmiş metin yazmanın en kolay yoludur. README dosyaları, belgeler, notlar, sohbet mesajları ve statik siteler onu kullanır. Bu kopya kâğıdı, gerçekten kullanacağınız sözdizimini ele alıyor ve GitHub-Flavored Markdown (GFM) üzerine odaklanıyor — GitHub, GitLab, çoğu belgeleme aracı ve Markdown Preview Editor tarafından desteklenen lehçe.

Aşağıdaki her örneği çevrim içi editöre yapıştırarak sonucu yan yana görebilirsiniz.

Başlıklar

Satıra bir ile altı arasında # karakteri ve ardından bir boşlukla başlayın. Tek # sayfa başlığı, ## bir bölüm, ### bir alt bölümdür.

markdown# Sayfa başlığı
## Bölüm
### Alt bölüm
#### Daha küçük başlık

Her belgede tek bir # başlığı kullanın ve seviye atlamayın (örneğin ## başlığından doğrudan #### başlığına geçmeyin). Ekran okuyucular ve arama motorları sayfayı anlamak için başlık yapısını kullanır; çoğu önizleyici de içindekiler tablosunu bu yapıdan oluşturur.

Paragraflar ve satır sonları

Paragraf, boş bir satırla ayrılmış bir veya daha fazla metin satırıdır. Paragraf içindeki tek bir satır sonu yok sayılır — satırlar birleştirilir. Satır sonunu zorlamak için satırı iki boşlukla ya da ters eğik çizgiyle bitirin:

markdownSonunda iki boşluk olan ilk satır  
Aynı paragraftaki ikinci satır.

Boş bir satırdan sonra yeni paragraf başlar.

Vurgu

Markdown Preview Editor dahil birçok editör, birkaç popüler uzantıyı da destekler: ==vurgulama==, alt simge için H~2~O, üst simge için x^2^ ve :smile: tarzı emoji kısa kodları. Bunlar GFM’nin bir parçası değildir; bu yüzden kullanmadan önce hedef platformunuzu kontrol edin.

Listeler

Madde işaretli listeler için -, * veya +, numaralı listeler için sayılar kullanın. Öğeleri iç içe yerleştirmek için iki ile dört boşluk girinti verin.

markdown- Süt
- Ekmek
  - Tam buğday
  - Çavdar
- Kahve

1. Depoyu klonla
2. Bağımlılıkları yükle
3. Derlemeyi çalıştır

Numaralı listelerde sayıların doğru olması gerekmez — her satırda 1. yazsanız da liste 1, 2, 3 olarak görüntülenir. Farklı bir sayıyla (örneğin 5.) başlarsanız liste o sayıdan başlar.

Görev listeleri

Görev listeleri, liste öğelerini onay kutularına dönüştüren bir GFM uzantısıdır. README dosyaları, sürüm planları ve toplantı notları için idealdir.

markdown- [x] Taslağı yaz
- [x] Ekran görüntülerini ekle
- [ ] Yazıyı yayımla

Bağlantılar

markdown[Bağlantı metni](https://example.com)
[Başlıklı bağlantı](https://example.com "Üzerine gelince gösterilir")
<https://example.com>

[Kurulum rehberini][install] okuyun.

[install]: https://example.com/docs/install

Son biçim bir referans bağlantısıdır: URL belgenin sonunda bir kez tanımlanır ve bu da uzun paragrafları okunaklı tutar. [Kurulum](docs/setup.md) gibi göreli bağlantılar aynı projedeki diğer dosyalara işaret eder; Markdown Preview Editor’da, o belge başka bir sekmede açıksa bu bağlantılar o sekmeye geçer.

Görseller

Görseller, önüne ünlem işareti eklenmiş bağlantı sözdizimini kullanır. Köşeli parantez içindeki metin alternatif metindir — görseli göremeyen kişiler için onu betimleyin.

markdown![Canlı önizlemeli editör](images/screenshot.png)
![Logo](https://example.com/logo.svg "İsteğe bağlı başlık")

Yerel görsellere başvuran bir belgeyi önizlerken bütün klasörü açın ya da görselleri .md dosyasıyla birlikte bırakın; böylece önizleyici göreli yolları çözebilir.

Kod

Satır içi kod tek ters tırnak kullanır. Bloklar için kodu üçlü ters tırnak arasına alın ve sözdizimi renklendirme için dil adını ekleyin:

markdown```js
function greet(name) {
  return `Hello, ${name}!`;
}
```

Yaygın dil adları: js, ts, python, bash, json, yaml, html, css, sql, go, rust, diff. Kodunuzun kendisi üçlü ters tırnak içeriyorsa, yukarıdaki örnekte olduğu gibi onu dört ters tırnakla çevreleyin.

Tablolar

Sütunları dikey çizgilerle ayırın ve başlık satırının altına bir tire satırı koyun. Ayırıcı satırdaki iki nokta üst üste işaretleri hizalamayı belirler.

markdown| Özellik      | Ücretsiz | Notlar                   |
|:-------------|:--------:|-------------------------:|
| Önizleme     |    ✅    | Siz yazarken güncellenir |
| Dışa aktarma |    ✅    | HTML, PDF, .md           |

:--- sola, :---: ortaya, ---: sağa hizalar. Kaynakta sütunların hizalı olması gerekmez — ama iyi bir editör onları okunaklı tutar. Markdown Preview Editor’ın araç çubuğunda hazır bir şablon ekleyen bir tablo düğmesi vardır.

Alıntılar ve uyarı kutuları

Metni alıntılamak için satırların başına > koyun. GitHub ayrıca uyarı kutularını (alerts) destekler — özel bir ilk satıra sahip, renkli bilgi kutuları olarak görüntülenen alıntılar:

markdown> Sıradan bir alıntı.

> [!NOTE]
> Kullanıcıların bilmesi gereken faydalı bilgiler.

> [!TIP]
> İşleri daha iyi yapmak için yararlı bir tavsiye.

> [!WARNING]
> Hemen dikkat edilmesi gereken acil bilgi.

Beş uyarı türü vardır: NOTE, TIP, IMPORTANT, WARNING ve CAUTION. Onları ölçülü kullanın: bölüm başına bir uyarı göze çarpar, arka arkaya beş uyarı ise gürültüye dönüşür.

Dipnotlar

Dipnotlar, yan açıklamaları ana metnin dışında tutar. Not herhangi bir yerde tanımlanabilir; belgenin sonunda görüntülenir.

markdownMarkdown 2004'te ortaya çıktı.[^1]

[^1]: John Gruber tarafından, Aaron Swartz'ın yardımıyla.

Yatay çizgiler ve kaçış karakterleri

Kendi satırında üç veya daha fazla tire, yıldız ya da alt çizgi yatay bir çizgi oluşturur: ---. Öncesine boş bir satır koyun; aksi halde bir metin satırının altındaki --- o metni başlığa dönüştürür.

Markdown’ın başka türlü yorumlayacağı bir karakteri göstermek için onu ters eğik çizgiyle kaçırın: \*italik değil\*, \# başlık değil, \$5 (matematik etkinken işe yarar).

Matematik ve diyagramlar

Teknik yazımda iki uzantı standart hale geldi:

• Matematik — satır içi formüller için $E = mc^2$, blok denklemler için $$ … $$. Markdown’da matematik yazımı hakkındaki kapsamlı rehbere göz atın.
• Diyagramlar — mermaid dilini kullanan bir kod bloğu akış şemaları, sıralama diyagramları, Gantt şemaları ve daha fazlasını çizer. Markdown’da Mermaid diyagramları yazısına bakın.

Front matter

Statik site oluşturucular meta verileri dosyanın en üstündeki bir YAML bloğundan okur:

yaml---
title: Yazım
date: 2026-09-27
tags: [markdown, docs]
---

İyi bir önizleyici bu bloğu metin olarak göstermek yerine gizler. Markdown Preview Editor da tam olarak bunu yapar.

Sırada ne var?

Sözdizimini bilmek işin yarısıdır — diğer yarısı yazarken sonucu görmektir. Markdown’ı dosyalarınızı yüklemeden çevrim içi önizleme yazısını okuyun; belgeniz hazır olduğunda da Markdown’ı HTML veya PDF’e dönüştürmeyi öğrenin.