Markdown Öğreniyor musunuz? GitHub Başlangıç Rehberi

GitHub dünyasına yeni adım atanlar için hazırlanan bu rehber serisinde, proje yönetiminden otomasyona kadar birçok konuyu ele aldık. Şimdi ise karşınıza Markdown adıyla çıkan ve GitHub'ın temel taşlarından biri olan metin biçimlendirme diline odaklanıyoruz. Bu basit ama güçlü araç sayesinde README dosyalarınızdan sorun bildirimlerine kadar her yerde profesyonel görünümlü içerikler oluşturabileceksiniz.

Markdown öğrenmek, yalnızca GitHub'da değil, aynı zamanda modern not alma uygulamalarında, blog platformlarında ve teknik dokümantasyon araçlarında da size büyük avantaj sağlayacak. Bu rehberde, temel sentaks kurallarından başlayarak pratik uygulamalara kadar her şeyi adım adım keşfedeceksiniz. Hazırsanız, başlayalım!

Markdown Nedir ve Neden Önemlidir?

Markdown, düz metinleri biçimlendirmek için geliştirilmiş hafif bir dildir. GitHub platformunda README dosyalarından sorun bildirimlerine, hatta sohbet mesajlarına kadar hemen her yerde karşınıza çıkar. Temel olarak, HTML'e kıyasla çok daha basit bir sentaks kullanırken, gerektiğinde HTML etiketlerini de destekleyebilirsiniz.

Bu dilin en büyük avantajlarından biri, okunabilirliği yüksek belgeler oluşturmanızı sağlamasıdır. Örneğin, yeni bir projeye katılan biri ilk kez README dosyanızı açtığında, düzgün biçimlendirilmiş bir içerik onu hemen bilgilendirecek ve yönlendirecektir. Ayrıca, Markdown'ın basit yapısı sayesinde, kısa sürede ustalaşıp hemen hemen her projede kullanabilirsiniz.

Markdown Nerelerde Kullanılır?

GitHub'da Markdown'unu en sık kullanacağınız yer, projenizin README.md dosyasıdır. Bunun yanı sıra, sorun bildirimlerinde, çekme isteklerinde, tartışma forumlarında ve hatta proje wiki'lerinde de bu dili kullanacaksınız. Temel olarak, GitHub'da herhangi bir yerde metin yazdığınızda, arka planda Markdown devreye girer ve içeriğinizi temiz ve tutarlı bir şekilde sunar.

Ancak Markdown'ın faydaları GitHub'la sınırlı değil. Bu dil, Notion, Obsidian, VS Code ve hatta Medium gibi platformlarda da destekleniyor. Bu da demektir ki, Markdown'ı öğrenmek, yalnızca GitHub deneyiminizi değil, dijital içerik oluşturma becerilerinizi de önemli ölçüde geliştirir.

Temel Markdown Sentaksına Göz Atın

Artık uygulamaya geçme zamanı! Aşağıda, en sık kullanacağınız temel Markdown kurallarını bulacaksınız. Hemen denemek için kendi .md uzantılı dosyanızı oluşturabilirsiniz:

• GitHub hesabınıza giriş yapın ve bir repo'ya gidin.
• Code sekmesine tıklayın.
• Üst menüde bulunan Add file düğmesine basın ve Create new file seçeneğini seçin.
• Dosya adını .md uzantısıyla bitirecek şekilde girin (örneğin, ornek-markdown.md).
• Editörde Edit düğmesine tıklayın.
• Aşağıdaki sentaksları deneyerek metinlerinizin nasıl göründüğünü Preview sekmesinden görebilirsiniz.

Başlıklar Oluşturma

Her belgenin olmazsa olmazı başlıklardır. Markdown'da başlık oluşturmak için # simgesini kullanırsınız. Başlık düzeyi ne kadar yüksekse, # sayısı da o kadar az olur:

# Ana Başlık (H1)
## Alt Başlık (H2)
### Üçüncü Düzey Başlık (H3)
#### Dördüncü Düzey Başlık (H4)

Metin Biçimlendirme

Metninizi vurgulamak için kalın, italik veya ikisinin kombinasyonunu kullanabilirsiniz. Aşağıdaki örneklerde, aynı sonucu verecek farklı yöntemleri görebilirsiniz:

*Bu metin italik* ya da _bu metin de italik_
**Bu metin kalın** ya da __bu metin de kalın__
***Hem kalın hem de italik*** ya da ___aynı sonuç___

Alıntılar ve Bloklar

Önemli bir metni vurgulamak için > simgesini kullanabilirsiniz. Tek satırlık bir alıntı oluşturabileceğiniz gibi, çok satırlı blok alıntılar da yaratabilirsiniz:

> Bu bir tek satırlık alıntıdır.
>
> Bu ise çok satırlı
> bir alıntı örneğidir.

Listeler Oluşturma

Adımları veya seçenekleri sıralı bir şekilde sunmak için listeler kullanabilirsiniz. Sıralı listeler için rakamlar, sırasız listeler içinse -, * veya + sembollerini tercih edebilirsiniz:

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

- İlk seçenek
- İkinci seçenek
- Üçüncü seçenek

Liste içi liste oluşturmak içinse dört boşlukluk girintileme yapabilirsiniz:

1. Ana adım
   - Alt adım 1
   - Alt adım 2
2. Diğer ana adım

Bağlantılar ve Resimler Ekleme

Başka bir sayfaya veya dosyaya bağlantı eklemek için köşeli parantez ve parantez kullanırsınız. Resim eklemek içinse aynı sentaksı kullanabilir, ancak başına ünlem işareti ekleyebilirsiniz:

GitHub'a gitmek için tıklayın
!Resim açıklaması

Kod Blokları ve Satır İçi Kod

Tek satırlık kod parçacıklarını tek geri tırnak () ile, çok satırlı kod bloklarınıysa üç geri tırnak ( `` ) ile oluşturabilirsiniz. Dil belirtmek, kodun renklendirilmesini kolaylaştırır:

print("Merhaba, Dünya!")

Satır içi kod içinse print() gibi tek geri tırnak kullanabilirsiniz.

Markdown’ı Pratikte Kullanmaya Başlayın

Artık temel Markdown sentaksını öğrendiğinize göre, GitHub'daki projelerinizde hemen uygulamaya başlayabilirsiniz. README dosyalarınızı zenginleştirmekten, sorun bildirimlerinizi daha anlaşılır hale getirmeye kadar birçok alanda bu basit dilin gücünden faydalanabilirsiniz.

Markdown'ı öğrenmek, yalnızca teknik projelerinizde değil, aynı zamanda günlük notlarınızda ve blog yazılarınızda da size büyük kolaylık sağlayacaktır. Hızla yaygınlaşan bu dil, dijital içerik oluşturmanın geleceğinde önemli bir yer edinmeye devam edecek. Şimdi klavyenizi açın ve pratik yapmaya başlayın!