Markdown Tam Rehberi: Sözdizimi, İpuçları ve Gerçek Kullanım Alanları (2026)

Markdown Nedir?

Markdown, John Gruber tarafından 2004 yılında oluşturulan hafif bir işaretleme dilidir. Yıldız, kare, köşeli parantez gibi basit semboller kullanarak düz metni biçimlendirmenizi ve HTML olarak render etmenizi sağlar. Temel fikir şudur: bir Markdown dosyası render edilmeden bile okunabilir olmalıdır.

Bugün Markdown her yerde karşımıza çıkar: GitHub README'ları, dokümantasyon siteleri, blog platformları (Ghost, Hashnode, Dev.to), not alma uygulamaları (Notion, Obsidian, Bear), mesajlaşma araçları (Slack, Discord) ve statik site oluşturucular (Jekyll, Hugo, Astro).

Başlıklar

# H1 — Sayfa Başlığı
## H2 — Bölüm
### H3 — Alt Bölüm
#### H4  ##### H5  ###### H6

Vurgu: Kalın, İtalik, Üstü Çizili

**kalın metin**
*italik metin*
***kalın ve italik***
~~üstü çizili~~
`satır içi kod`

Listeler

- Sırasız öğe
- İkinci öğe
  - İç içe öğe

1. Birinci öğe
2. İkinci öğe

- [x] Tamamlanan görev
- [ ] Bekleyen görev

Bağlantılar ve Görseller

[Bağlantı metni](https://ornek.com)
![Alternatif metin](gorsel.jpg)
[![Bağlantılı görsel](rozet.svg)](https://ornek.com)

Kod

`satır içi kod`

```python
def selamla(isim):
    return f"Merhaba, {isim}!"
```

Tablolar (GFM)

| Araç          | Kategori  | Ücretsiz? |
|---------------|-----------|-----------|
| JSON Formatlayıcı | Geliştirici | Evet |
| Regex Test    | Geliştirici | Evet  |

| Sol hizalı | Orta hizalı | Sağ hizalı |
|:-----------|:-----------:|-----------:|

Markdown Kullanıldığı Yerler

• GitHub: README, wiki, issue yorumları, pull request açıklamaları
• Dokümantasyon: MkDocs, Docusaurus, GitBook, VitePress
• Not alma: Obsidian, Notion, Bear, Joplin
• Bloglar: Ghost, Hashnode, Dev.to, Jekyll, Hugo
• Mesajlaşma: Slack, Discord, Mattermost
• AI: ChatGPT, Claude, Gemini yanıtları Markdown render eder

Hızlı Başvuru

# H1  ## H2  ### H3

**kalın**   *italik*   ~~üstü çizili~~   `kod`

- sırasız   1. sıralı   - [x] görev

[metin](url)     ![alt](gorsel.jpg)

> alıntı

```dil
kod bloğu
```

| Sütun1 | Sütun2 |
|--------|--------|