Markdown nedir?

Markdown, sade metin kullanarak biçimlendirilmiş içerik yazmayı sağlayan hafif bir işaretleme dilidir. Yani yazının içine bazı basit semboller ekleyerek başlık, liste, bağlantı, alıntı, kod bloğu ve tablo gibi yapılar oluşturursun.

Örneğin bir başlık yazmak için karmaşık bir menüye girmezsin. Satırın başına `#` koyarsın. Kalın yazı için kelimeyi çift yıldız arasına alırsın. Liste için satır başına tire koyarsın. Bu kadar basit.

Neden klasik Word mantığından farklıdır?

Word veya benzeri editörlerde yazıyı biçimlendirmek için genelde görsel araçlar kullanırsın. Başlığı seçer, butona basar, fontu değiştirir, tablo ekler, renk ayarlarsın. Bu yaklaşım özellikle resmi belgeler, raporlar ve baskıya gidecek dokümanlar için çok kullanışlıdır.

Markdown ise başka bir bakış açısına sahiptir. Önceliği görsel tasarım değil, yapıdır. Yazının başlığı, alt başlığı, listesi, bağlantısı ve kod bloğu düz metin içinde açıkça görünür. Bu sayede belge hem insan tarafından okunabilir kalır hem de farklı sistemlere kolayca dönüştürülebilir.

Markdown neden ortaya çıktı?

Markdown’ın temel çıkış noktası, web için yazı yazmayı daha kolay hale getirmekti. HTML güçlüdür ama günlük yazı üretimi için fazla etiketli ve yorucu olabilir. Her paragraf, bağlantı, liste veya vurgu için HTML etiketi yazmak çoğu içerik üreticisi açısından pratik değildir.

Markdown bu boşluğu doldurur. İnsan tarafından kolay okunabilen bir metin yazarsın; gerektiğinde bu metin HTML’e dönüştürülebilir. Yani hem sade yazarsın hem de web uyumlu çıktı alabilirsin.

Markdown’ın başarısı, teknik olmakla sade olmak arasında çok iyi bir denge kurmasından gelir.

Temel Markdown yazım kuralları

Markdown öğrenmek için yüzlerce komut bilmek gerekmez. Günlük kullanımda birkaç temel yapı işin büyük kısmını çözer. Başlık, kalın yazı, italik, liste, alıntı, bağlantı, görsel, tablo ve kod bloğu Markdown’ın omurgasını oluşturur.

# Proje Notu

## Amaç
Bu proje, blog yazılarını daha düzenli planlamak için hazırlanıyor.

## Yapılacaklar
- Kategori yapısını belirle
- SEO alanlarını hazırla
- Kapak görseli promptu yaz
- Yayın kontrol listesini oluştur

## İlgili bağlantılar
[Markdown rehberi](https://example.com)

## Kod örneği
```php
echo "Merhaba Markdown";
```

Bu metin düz halde bile okunabilir. Aynı zamanda Markdown destekleyen bir editörde başlıklara, listelere, bağlantılara ve kod bloklarına dönüşür.

Başlık, kalın, italik, liste ve alıntı kullanımı

Markdown’da başlıklar `#` işaretiyle oluşturulur. Bir tane `#` ana başlık, iki tane `##` alt başlık, üç tane `###` daha küçük başlık anlamına gelir. Bu yapı hem okuyucu hem de arama motorları için içerik hiyerarşisini daha anlaşılır hale getirir.

• `# Ana Başlık` yazarsan H1 seviyesi başlık oluşturursun.
• `## Alt Başlık` yazarsan H2 seviyesi başlık oluşturursun.
• `**kalın metin**` önemli kelimeleri vurgulamak için kullanılır.
• `*italik metin*` daha yumuşak vurgu için tercih edilir.
• `- liste maddesi` hızlı maddeleme için kullanılır.
• `> alıntı` not, vurgu veya alıntı bölümü oluşturmak için kullanılır.

Bu yapıları öğrendiğinde Markdown’ın günlük kullanımının büyük kısmını çözmüş olursun. Özellikle not alma ve blog taslağı hazırlama tarafında bu temel komutlar fazlasıyla yeterlidir.

Bağlantı ve görsel ekleme

Markdown’da bağlantı eklemek oldukça basittir. Köşeli parantez içine görünen metni, normal parantez içine ise adresi yazarsın.

Tablolar: Küçük karşılaştırmaları düzenli göstermek

Markdown tabloları, özellikle küçük karşılaştırmalar için çok kullanışlıdır. Büyük ve karmaşık Excel tablolarının yerini tutmaz; ama kısa ürün karşılaştırmaları, özellik listeleri, sürüm notları veya içerik planları için oldukça pratiktir.

| Araç | Kullanım Alanı | Markdown Desteği |
|---|---|---|
| Obsidian | Not alma ve bilgi ağı | Güçlü |
| GitHub | README ve dokümantasyon | Güçlü |
| Blog sistemleri | İçerik üretimi | Sisteme göre değişir |

Tablo söz dizimi ilk başta biraz garip görünebilir. Ama birkaç kez kullandıktan sonra özellikle kısa teknik notlarda çok hızlı sonuç verir.

Kod blokları ve teknik dokümantasyon avantajı

Markdown’ın geliştiriciler arasında sevilmesinin en önemli nedenlerinden biri kod bloklarını temiz şekilde gösterebilmesidir. Üç ters tırnak kullanarak kod bloğu açabilir, dil adını yazarak sözdizimi renklendirmesi yapılmasını sağlayabilirsin.

```js
const title = "Markdown Rehberi";
console.log(title);
```

Obsidian, GitHub ve blog sistemlerinde Markdown kullanımı

Markdown’ın gücü, tek bir uygulamaya bağlı olmamasından gelir. Obsidian, Markdown dosyalarını kişisel bilgi sistemi haline getirir. GitHub, README ve proje dokümantasyonlarında Markdown’ı yaygın şekilde kullanır. Birçok statik site üretici, blog motoru ve dokümantasyon sistemi de Markdown dosyalarını içerik kaynağı olarak kabul eder.

Markdown’ın avantajları

Markdown’ın avantajlarını yalnızca “kolay yazılıyor” diye özetlemek eksik olur. Asıl değeri, yazıyı uzun vadeli, sade ve taşınabilir hale getirmesidir.

• Dosyalar düz metin mantığına yakın olduğu için uzun vadede okunabilir kalır.
• Farklı editörler ve platformlar arasında taşınması kolaydır.
• Yazarken biçimlendirme menüleriyle uğraştırmaz.
• HTML, PDF veya web sayfasına dönüştürülmesi kolaydır.
• Kod blokları ve teknik açıklamalar için çok uygundur.
• Obsidian gibi kişisel bilgi yönetimi araçlarıyla güçlü çalışır.
• GitHub ve dokümantasyon kültürünün doğal bir parçasıdır.

Markdown’ın sınırlamaları

Markdown güçlüdür ama her iş için en doğru araç değildir. Çok detaylı sayfa mizanpajı, karmaşık tasarım, gelişmiş tablo düzeni, baskı odaklı raporlar veya görsel olarak ağır belgeler için Word, Google Docs, InDesign ya da özel dokümantasyon araçları daha uygun olabilir.

Ayrıca farklı platformlarda Markdown yorumlama şekli küçük farklılıklar gösterebilir. Örneğin GitHub Flavored Markdown bazı ek özellikler sunar; bazı editörlerde tablo, görev listesi veya dipnot desteği farklı çalışabilir. Bu yüzden bir içeriği nerede yayınlayacaksan, o platformun Markdown desteğini kontrol etmek iyi olur.

Yeni başlayanlar için mini Markdown şablonu

Markdown’a başlamak için karmaşık bir eğitim sürecine gerek yok. Aşağıdaki şablon; blog fikri, teknik not, proje dokümanı veya kişisel araştırma için temel bir başlangıç yapısı olarak kullanılabilir.

# Başlık

## Kısa Özet
Bu notun veya yazının ana fikri birkaç cümleyle burada açıklanır.

## Amaç
Bu içerik neden hazırlanıyor?

## Ana Başlıklar
- Birinci konu
- İkinci konu
- Üçüncü konu

## Kaynaklar
- [Kaynak adı](https://example.com)

## Notlar
> Buraya önemli alıntı veya vurgu yazılabilir.

## Kod / Komut Örneği
```bash
npm install
```

## Sonraki Adımlar
- [ ] İlk taslağı tamamla
- [ ] Eksikleri kontrol et
- [ ] Yayına hazırla

Bu basit yapı bile birçok içerik için yeterlidir. Zamanla kendi kullanım alanına göre “SEO notları”, “ilgili bağlantılar”, “ekran görüntüleri”, “karar kayıtları” veya “yapılacaklar” gibi bölümler ekleyebilirsin.

Markdown öğrenmek Obsidian’ı neden güçlendirir?

Obsidian kullanan biri için Markdown bilmek büyük avantajdır. Çünkü Obsidian’ın temelinde Markdown dosyaları vardır. Başlıkları doğru kullanmak, listeleri temiz tutmak, bağlantılar eklemek, kod blokları yazmak ve notları düzenli yapılandırmak Obsidian deneyimini çok daha verimli hale getirir.

Obsidian’da [[bağlantılı notlar]] mantığı Markdown’ın üzerine ekstra bir bilgi ağı katmanı ekler. Yani Markdown sana temiz yazı yapısını verir; Obsidian bu yazıları birbirine bağlayarak kişisel bilgi sistemine dönüştürür.

Markdown yazının iskeletini kurar; Obsidian ise o iskeletleri birbirine bağlayarak kişisel bilgi ağına dönüştürür.

Blog yazısı hazırlarken Markdown nasıl kullanılır?

Blog yazısı hazırlarken Markdown çok pratik bir taslak formatıdır. Önce başlığı ve alt başlıkları kurarsın. Sonra her başlığın altına notlarını eklersin. Kaynakları bağlantı olarak tutarsın. Gerekiyorsa kod örneklerini ayrı bloklar halinde yazarsın.

Bu yöntem özellikle uzun yazılarda çok işe yarar. Çünkü yazıyı önce içerik olarak netleştirir, tasarımı daha sonra düşünürsün. Böylece yazı üretim sürecinde “font ne olsun, kutu nasıl görünsün, renk ne olsun?” gibi sorularla bölünmezsin.

1. Başlığı belirle Markdown dosyasının ilk satırına ana başlığı yaz ve H1 olarak işaretle.
2. Alt başlıkları çıkar Yazının iskeletini ## başlıklarıyla kur. Böylece içerik akışı baştan netleşir.
3. Kaynakları not içinde tut Bağlantıları yazı içinde veya en altta kaynaklar bölümünde sakla.
4. Kod ve örnekleri ayır Teknik içeriklerde komutları ve kodları ayrı bloklar halinde göster.
5. Sonradan HTML’e dönüştür Yazı olgunlaştığında blog sistemine, HTML şablonuna veya yayın aracına aktar.

Markdown günlük üretim akışında nerede durmalı?

Markdown’ı en verimli kullanma yolu, onu nihai tasarım aracı gibi değil, içerik üretiminin temiz taslak dili gibi düşünmektir. Önce fikri Markdown ile sade şekilde yazarsın. Başlıkları, listeleri, bağlantıları, kaynakları ve örnekleri netleştirirsin. Sonra bu içeriği Obsidian’da bilgi ağına, GitHub’da README dosyasına, blog sisteminde makaleye veya teknik dokümantasyona dönüştürebilirsin.

Bu yaklaşım özellikle düzenli içerik üreten kişiler için çok değerlidir. Çünkü Markdown, fikir ile yayın arasındaki karmaşayı azaltır. İçeriğin önce anlamı ve yapısı netleşir; görsel tasarım ise daha sonra devreye girer.

• Obsidian’da fikir ve araştırma notu olarak kullanılabilir.
• GitHub’da README ve proje açıklaması yazmak için kullanılabilir.
• Blog yazılarında ilk taslak formatı olarak kullanılabilir.
• Teknik dokümantasyonda komut, kod ve açıklamaları düzenli göstermek için kullanılabilir.
• Kişisel bilgi arşivinde uzun ömürlü ve taşınabilir metinler oluşturmak için kullanılabilir.

Sonuç: Markdown küçük bir alışkanlık, büyük bir üretim avantajıdır

Markdown öğrenmek zor değildir. Aslında birkaç temel işareti öğrendikten sonra günlük kullanımın büyük kısmını rahatça yapabilirsin. Ama kazandırdığı düzen, özellikle uzun vadede çok değerlidir.

Notlarını daha temiz tutarsın. Blog taslaklarını daha hızlı hazırlarsın. GitHub README dosyalarını daha profesyonel yazarsın. Teknik dokümantasyonlarını daha okunabilir hale getirirsin. Obsidian içinde kişisel bilgi arşivini daha sağlam kurarsın.

En önemlisi de içeriğini tek bir uygulamaya hapsetmezsin. Düz metin mantığı sayesinde bugün yazdığın şey, yarın başka bir araçta da anlamını korur.