Markdown Nedir? Neden Kullanılır?

Markdown, yazıyı biçimlendirmek için kullanılan hafif bir işaretleme dilidir. Karmaşık bir kelime işlemci arayüzüne ihtiyaç duymadan başlık, liste, link, görsel, tablo ve kod bloğu gibi yapıları düz metin içinde yazmanı sağlar.

Bu rehber dizisi Markdown'ı sadece "kalın yazı nasıl yapılır?" seviyesinde anlatmayacak. Amaç, Markdown'ı CBS tarzı üretim sisteminin bir parçası olarak düşünmek: not almak, içerik üretmek, rehber yazmak, Obsidian kullanmak, Git ile versiyonlamak ve gerektiğinde MDX/Next.js içinde yayınlamak.

1. Markdown'ın Ana Fikri

Markdown'ın temel fikri şudur:

Yazı önce okunabilir düz metin olmalı; biçimlendirme yazının üstüne yük olmamalı.

Normal bir .docx dosyasında biçimlendirme dosyanın içinde görünmez bir katman olarak saklanır. Markdown'da ise biçimlendirme metnin kendisidir.

Örneğin:

## Başlık

Bu paragrafta **önemli bir ifade** var.

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

Bu metni herhangi bir düz metin editöründe okuyabilirsin. Aynı metin bir Markdown görüntüleyicide başlık, kalın ifade ve liste olarak görünür.

2. Markdown Hangi Sorunu Çözer?

Markdown üç ana sorunu çözer.

2.1 Yazma Sürtünmesini Azaltır

Kelime işlemcilerde yazarken sürekli biçim düğmelerine, menülere ve stillere dokunursun. Markdown'da parmakların klavyeden ayrılmaz.

Bu özellikle ADHD ve dağınık zihinler için önemlidir. Çünkü biçimlendirme arayüzü bazen yazının kendisinden daha fazla dikkat çeker.

Markdown'da şunu düşünürsün:

• Bu başlık mı?
• Bu liste mi?
• Bu link mi?
• Bu kod mu?
• Bu alıntı mı?

Yeterli.

2.2 Dosyayı Taşınabilir Yapar

Markdown dosyası düz metindir. Bu yüzden:

• Obsidian'da açılır.
• VS Code'da düzenlenir.
• GitHub'da okunur.
• Next.js/MDX içinde yayınlanır.
• Statik site generator'larda çalışır.
• 10 yıl sonra da büyük ihtimalle açılır.

Bu, kişisel bilgi yönetimi için ciddi bir avantajdır. Bir uygulamaya kilitlenmezsin.

2.3 Yapıyı Görünür Kılar

Markdown, yazının iskeletini metnin içinde gösterir. Başlıklar, listeler ve bölümler gözle seçilir.

Bu sayede uzun bir rehber yazarken metnin yapısı kaybolmaz.

## Problem
## Neden Olur?
## Çözüm
## Uygulama
## Sonraki Adım

Bu beş satır bile yazının haritasını çıkarır.

3. Markdown Nerelerde Kullanılır?

Markdown birçok alanda standart haline geldi.

CBS açısından Markdown özellikle üç yerde değerlidir:

• Rehber ve blog içerikleri.
• Obsidian tabanlı kişisel bilgi yönetimi.
• Ürün, araç ve şablon dokümantasyonu.

4. Markdown ile HTML Arasındaki Fark

Markdown, HTML'in yerine geçen tam bir sistem değildir. Daha çok HTML yazmayı kolaylaştıran sade bir katmandır.

Markdown:

[Chaotic Brain Studio](/)

HTML karşılığı:

<a href="/">Chaotic Brain Studio</a>

Markdown daha okunabilir ve hızlıdır. Ama çok özel layout, component veya interaktif yapı gerekiyorsa HTML/MDX gerekir.

5. Markdown ile MDX Arasındaki Fark

Markdown düz içeriktir. MDX ise Markdown içine React component yazmana izin verir.

Markdown:

## Başlık

Normal içerik.

MDX:

## Başlık

<Callout type="warning">
  Bu özel bir component.
</Callout>

CBS sitesinde içerik dosyaları .mdx uzantılı olsa bile çoğu rehber düz Markdown gibi yazılıyor. Bu iyi bir şey. Gereksiz component kullanmadan içerik hızlı kalır.

6. Markdown'ın Güçlü Yanları

6.1 Hız

Başlık, liste ve link yazmak çok hızlıdır. Yazı akışını bölmez.

6.2 Sadelik

Markdown öğrenmek için yüzlerce kural gerekmez. Temel sözdizimi birkaç saat içinde kullanılabilir.

6.3 Versiyon Kontrolü

Markdown düz metin olduğu için Git ile çok iyi çalışır. Bir yazıda ne değiştiğini satır satır görebilirsin.

6.4 Uzun Ömür

Markdown dosyası belirli bir uygulamaya bağımlı değildir. Bu, kişisel bilgi sistemleri için çok değerlidir.

6.5 Arama ve Otomasyon

Düz metin olduğu için aramak, dönüştürmek, script ile işlemek ve yayın pipeline'ına sokmak kolaydır.

7. Markdown'ın Sınırları

Markdown her şey değildir.

7.1 Tasarım Aracı Değildir

Markdown ile yazının yapısını kurarsın; görsel tasarımı genelde site veya uygulama teması belirler.

Bu yüzden Markdown dosyasında şu soruya odaklan:

• Bu metnin anlamlı yapısı ne?

Şuna değil:

• Bu kutu tam kaç piksel olmalı?

7.2 Standartlar Değişebilir

GitHub Flavored Markdown, CommonMark, Obsidian Markdown ve MDX arasında küçük farklar olabilir.

Örneğin:

• Görev listeleri her yerde aynı görünmeyebilir.
• Wikilink [[Not]] her platformda çalışmaz.
• Frontmatter her sistemde aynı şekilde okunmaz.

7.3 Çok Karmaşık Belgelerde Zorlanabilir

Sayfa tasarımı ağır, çok sütunlu, görsel düzeni yüksek dokümanlar için Markdown tek başına yeterli olmayabilir.

Ama rehber, not, dokümantasyon ve blog için fazlasıyla yeterlidir.

8. Markdown Öğrenirken Doğru Sıra

Markdown'ı öğrenirken her şeyi ezberleme. Şu sırayla ilerle:

1. Başlıklar
2. Paragraflar
3. Kalın ve italik
4. Listeler
5. Linkler
6. Görseller
7. Kod blokları
8. Tablolar
9. Frontmatter
10. MDX farkları

Bu dizinin sonraki bölümleri bu sırayı takip edecek.

9. ADHD Dostu Markdown Yaklaşımı

Markdown öğrenirken en büyük hata, bunu da yeni bir mükemmel sistem projesine çevirmektir.

Başlamak için minimum yapı:

# Not Başlığı

## Fikir

## Örnek

## Sonraki Adım

Bu kadar.

Önce yaz. Sonra yapılandır. En son temizle.

10. İlk Markdown Dosyan

Bir ilk-not.md dosyası aç ve şunu yaz:

# İlk Markdown Notum

Bugün Markdown öğrenmeye başladım.

## Neden?

- Daha hızlı yazmak istiyorum.
- Notlarım uygulamaya kilitli kalmasın istiyorum.
- Rehber ve blog yazılarını daha temiz hazırlamak istiyorum.

## Sonraki Adım

Markdown sözdizimi rehberini okuyacağım.

Dosyayı kaydet. Herhangi bir Markdown editöründe aç. Bu ilk çalışma için yeterli.

11. Bu Dizide Ne Var?

Bu Markdown rehber dizisi altı bölümden oluşuyor:

12. Sonraki Adım

Bir sonraki bölümde Markdown'ın gerçek sözdizimini öğreneceksin: başlık, liste, link, görsel, kod bloğu, tablo, alıntı, görev listesi ve frontmatter.

Markdown'ın mantığını anladıysan artık klavyede karşılığına geçebiliriz.