Markdown Sözdizimi Rehberi

Markdown öğrenmenin en iyi yolu, en sık kullanılan parçaları sırayla öğrenmektir. Bu rehber bir referans sayfası gibi çalışır: yazarken takıldığında geri dönüp bakabilirsin.

Ama önemli bir uyarı var: Markdown biçimlendirme koleksiyonu değildir. Metnin anlamını açık hale getiren sade bir yapı dilidir.

1. Başlıklar

Başlıklar # karakteriyle yazılır.

# H1 Başlık
## H2 Başlık
### H3 Başlık
#### H4 Başlık

Genel kullanım:

• # sayfanın ana başlığıdır.
• ## ana bölümler içindir.
• ### alt bölümler içindir.
• Daha derin seviyeleri nadiren kullan.

İyi Başlık Örneği

# Markdown Rehberi

## Markdown Nedir?

## Temel Sözdizimi

### Başlıklar
### Listeler
### Linkler

Kötü Başlık Örneği

## Markdown Rehberi
#### Başlıklar
# Linkler
### Sonuç

Başlık seviyesi zıplarsa metnin haritası bozulur.

2. Paragraflar

Markdown'da paragraf için özel işaret gerekmez. Boş satır paragraf ayırır.

Bu bir paragraf.

Bu ikinci paragraf.

Paragraf içinde satır kırmak her zaman yeni paragraf anlamına gelmeyebilir. En temiz yaklaşım: paragraflar arasında boş satır bırak.

3. Kalın ve İtalik

Kalın:

Bu **önemli** bir ifade.

İtalik:

Bu *vurgulu* bir ifade.

Kalın + italik:

Bu ***çok güçlü vurgulu*** bir ifade.

CBS tarzı pratik kural:

• Kalın metni az kullan.
• Her paragrafta birden fazla kalın ifade varsa metin yorucu olur.
• Kalın ifade gerçek vurgu için kullanılmalı.

4. Listeler

Sırasız Liste

- İlk madde
- İkinci madde
- Üçüncü madde

Sıralı Liste

1. İlk adım
2. İkinci adım
3. Üçüncü adım

Liste Yazarken Pratik Kural

Liste maddeleri aynı türden olmalı.

İyi:

- Başlığı yaz
- Taslağı çıkar
- Linkleri ekle
- Yayın öncesi kontrol yap

Zayıf:

- Başlığı yaz
- Markdown hızlıdır
- Linkler
- Sonra bakarız

Bir liste ya adım listesi olmalı ya özellik listesi olmalı ya kontrol listesi olmalı. Karışık listeler okuyucuyu yorar.

5. Linkler

Markdown link formatı:

[Görünen metin](https://example.com)

Site içi link:

[Sözlük](/sozluk)

Rehber linki:

[Zettelkasten Rehberi](/rehberler/zettelkasten-rehberi)

Link Metni Nasıl Yazılmalı?

İyi:

[Markdown dosya mimarisi rehberi](/rehberler/markdown-dosya-mimarisi-frontmatter-metadata)

Zayıf:

[buraya tıkla](/rehberler/markdown-dosya-mimarisi-frontmatter-metadata)

Link metni hedefi açıklamalı. Hem kullanıcı hem SEO için daha iyidir.

6. Görseller

Görsel formatı linke benzer; başında ! vardır.

![Alternatif metin](/images/markdown-editor.png)

Alternatif metin sadece formalite değildir. Görsel yüklenmezse, ekran okuyucu kullanılırsa veya SEO bağlamı gerekiyorsa işe yarar.

İyi:

![Obsidian içinde Markdown not yapısı](/images/obsidian-markdown-note.png)

Zayıf:

![image](/images/screenshot.png)

7. Alıntılar

Alıntı için > kullanılır.

> Markdown'ın gücü, yazıyı düz metin olarak okunabilir tutmasıdır.

Alıntıyı şu durumlarda kullan:

• Bir kaynaktan kısa alıntı.
• Kısa uyarı veya prensip.
• Metin içinde ayrışması gereken düşünce.

Her önemli cümleyi alıntı yapma. Alıntı çoğalınca etkisi azalır.

8. Kod ve Kod Blokları

Satır içi kod:

Dosya uzantısı `.md` olmalı.

Kod bloğu:

\```markdown
## Başlık

- Liste maddesi
\```

Dil belirtmek iyi bir alışkanlıktır:

\```ts
const title = "Markdown Rehberi";
\```

Dil belirtmek syntax highlighting sağlar.

9. Tablolar

Tablo formatı:

| Alan | Açıklama |
| --- | --- |
| title | Yazı başlığı |
| date | Yayın tarihi |
| tag | Kategori |

Tablolar özellikle karşılaştırma için iyidir.

İyi kullanım:

Tabloyu uzun paragraf yerine kullanma. Tablo karşılaştırma içindir.

10. Görev Listeleri

GitHub Flavored Markdown görev listelerini destekler:

- [ ] Taslağı yaz
- [ ] Linkleri kontrol et
- [x] Başlığı netleştir

Obsidian ve GitHub gibi araçlarda bu kutucuk olarak görünür.

Görev listesi için pratik kural:

• Kısa görevler için kullan.
• Uzun proje yönetimini sadece Markdown checkbox'a yükleme.
• Her madde yapılabilir aksiyon olsun.

11. Yatay Çizgi

Yatay çizgi için üç tire kullanılabilir:

---

Bunu bölüm ayırıcı olarak kullanabilirsin ama sık kullanma. Başlık yapısı çoğu zaman yeterlidir.

12. Frontmatter

Frontmatter, dosyanın en üstünde yer alan metadata alanıdır.

---
title: "Markdown Sözdizimi Rehberi"
date: "2026-05-07"
tag: "Sistemler ve Araçlar"
---

CBS sitesindeki rehberlerde frontmatter sayfanın başlık, açıklama, kategori, seri ve ilişkili rehber bilgilerini taşır.

Örnek:

---
title: "Markdown Rehberi"
subtitle: "Markdown'ı sıfırdan öğrenmek için kapsamlı rehber."
date: "2026-05-07"
readTime: "20 dk okuma"
author: "Chaotic Brain Studio"
tag: "Sistemler ve Araçlar"
series: "markdown-rehberi"
seriesTitle: "Markdown Rehberi"
seriesOrder: 2
---

Frontmatter Yazarken Dikkat

YAML iki noktaya duyarlıdır. Liste içinde iki nokta kullanacaksan tüm satırı tırnak içine almak güvenlidir.

Riskli:

tldr:
  - Problem: Markdown yazarken yapı bozuluyor

Güvenli:

tldr:
  - "Problem: Markdown yazarken yapı bozuluyor"

13. Kaçış Karakterleri

Bazen Markdown karakterini biçimlendirme olarak değil, düz karakter olarak göstermek istersin.

\*Bu italik olmaz\*

Ekranda şöyle görünür:

*Bu italik olmaz*

14. Satır İçi HTML

Bazı Markdown sistemleri HTML destekler:

<strong>Kalın metin</strong>

Ama bunu son çare gibi düşün. Eğer Markdown karşılığı varsa Markdown kullan.

15. Obsidian Wikilinkleri

Obsidian şu formatı destekler:

[[Not Başlığı]]

Bu standart Markdown değildir. Obsidian içinde harikadır ama her yerde çalışmaz.

Eğer içerik web sitesine taşınacaksa standart link daha güvenlidir:

[Not Başlığı](/rehberler/not-basligi)

16. Sık Yapılan Hatalar

Hata 1: Başlıkları Görsel Boyut İçin Kullanmak

Başlık seviyesi anlam içindir, font boyutu için değil.

Hata 2: Çok Derin Liste Kullanmak

Çok iç içe liste okuyucuyu kaybettirir. Derinleşiyorsa yeni alt başlık aç.

Hata 3: Her Şeyi Kalın Yazmak

Her şey önemliyse hiçbir şey önemli değildir.

Hata 4: Link Metnini Belirsiz Yazmak

"Buraya tıkla" yerine hedefi anlatan link metni kullan.

Hata 5: Markdown'ı Tasarım Aracı Sanmak

Markdown yapı içindir. Görsel tasarım temanın işidir.

17. CBS Markdown Stil Rehberi

CBS içerikleri için pratik stil:

• Ana bölümler ## ile yazılır.
• Alt bölümler ### ile yazılır.
• Her bölüm kısa bir giriş paragrafıyla başlar.
• Uzun listeler tabloya veya alt başlıklara bölünür.
• Kod örneklerinde dil belirtilir.
• İç linklerde hedef açıklanır.
• Frontmatter temiz tutulur.
• Yazı sonunda sonraki adım verilir.

18. Mini Cheat Sheet

# H1
## H2
### H3

**kalın**
*italik*

- liste
- liste

1. adım
2. adım

[link metni](https://example.com)
![alt metin](/image.png)

> alıntı

`satır içi kod`

\```js
console.log("kod bloğu");
\```

| A | B |
| --- | --- |
| 1 | 2 |

19. Pratik Egzersiz

Şu yapıyı kendi kelimelerinle doldur:

# Markdown Öğrenme Notum

## Markdown Nedir?

## Bugün Öğrendiğim 5 Şey

- 
- 
- 
- 
- 

## Takıldığım Yer

## Sonraki Adım

Bu egzersiz temel sözdiziminin yüzde 70'ini kullandırır.

20. Sonraki Adım

Bir sonraki rehberde Markdown'ı not alma sistemine bağlayacağız: günlük not, inbox, MOC, Zettelkasten, Obsidian klasörleri ve ADHD dostu capture akışı.