Markdown, içerik yazımını kolaylaştırmak amacıyla oluşturulmuş basit bir dildir. GitHub’tan not alma uygulamalarına kadar her yerde kullanılır. Bir yazar, geliştirici ya da sadece çevrimiçi yazı yazmayı kolaylaştırmak isteyen biriyseniz, bu rehber tam size göre!
Markdown, 2004’te John Gruber tarafından basit metin düzenleyicilerde formatlı metni okunabilir yapmak için oluşturulan hafif bir işaretleme dilidir. Bloglar, anlık mesajlar, forumlar, işbirlikçi araçlar, dökümantasyon ve readme dosyaları için özellikle popülerdir. Zamanla, farklı yorumların ortaya çıkmasıyla 2014’te CommonMark ortaya çıktı, bu da tutarlı uygulamayı garanti altına almak için test sistemiyle birlikte daha net bir spesifikasyonu temsil ediyor.
İşte ihtiyaç duyacağınız en yaygın öğelerin hızlı bir özeti:
#
karakterini bir boşlukla kullanarak başlık oluşturun:
# Bu bir H1 başlığıdır
## Bu bir H2 başlığıdır
### Bu bir H3 başlığıdır
İtalik için *yıldız*
ya da _alt çizgi_
kullanın.
Kalın metin için **çift yıldız**
ya da __çift alt çizgi__
kullanın.
Yıldız, artı ya da eksi işaretini bir boşlukla kullanın:
* Madde 1
* Madde 2
* Alt madde 2.1
* Alt madde 2.2
Sadece bir numara ve ardından bir nokta kullanın:
1. İlk madde
2. İkinci madde
3. Üçüncü madde
Aşağıdaki sözdizimini kullanarak bir bağlantı oluşturabilirsiniz:
[Gösterim metni](URL "İsteğe bağlı başlık")
Görseller, bağlantılara benzer, ama önünde bir ünlem işareti vardır:
![Alternatif metin](URL "İsteğe bağlı başlık")
Alıntı için metninizden önce >
işaretini kullanın:
> Bu bir alıntıdır.
Satır içi kod
için metni ters tırnak içine alın:
`burada kod`
Çok satırlı kod blokları için üç ters tırnak kullanın:
\```
Kodun 1. satırı
Kodun 2. satırı
Kodun 3. satırı
\```
Üç çizgi, yıldız ya da alt çizgi kullanarak bir yatay çizgi oluşturabilirsiniz:
---
| Başlık1 | Başlık2 |
|---------|---------|
| hücre1 | hücre2 |
| hücre3 | hücre4 |
- [x] Tamamlanan görev
- [ ] Tamamlanmamış görev
Üzeri çizili metin için ~~
kullanın:
~~üzeri çizili~~
Markdown dosyanıza @
işaretiyle birlikte alıntı anahtarı ekleyerek alıntı ekleyebilirsiniz. Örneğin:
Yakın tarihli araştırmalara göre [@Smith2023], etkinin...
Birden çok alıntı da kullanabilirsiniz:
Bazı araştırmacılar bu görüşü destekliyor [@Smith2023; @Doe2022].
Dolaylı (veya metin içi) alıntılar, yazarı ve yılı parantez içinde yerleştirir:
[@Smith2023] tarafından belirtildiği gibi...
Doğrudan alıntılar aynı zamanda sayfa numarasını da içerir:
[@Smith2023, ss. 33-35] şöyle belirtiyor...