Markdown, aynı adlı bir araçla HTML’ye ve diğer birçok biçime dönüştürülebilmesi için tasarlanmış, düz metin biçimlendirme sözdizimine sahip hafif bir işaretleme dilidir ve John Gruber tarafından geliştirilmiştir. Markdown sıklıkla benioku (readme) dosyalarını biçimlendirmek, çevrimiçi tartışma forumlarında ileti yazmak ve bir düz metin düzenleyici kullanarak zengin metinler oluşturmak için kullanılır.

Markdown

Bölüm Başlıkları

Bir web sayfası ya da blog yazısı oluştururken farklı düzeylerde başlıklar tanımlayabilirsiniz. Başlıklardan en önemlisi, genellikle her sayfada bir adet ve sayfanın tepesinde bulunan başlık 1’dir. Bir satırın başına tek bir ‘#’ karakteri koyarak, düzey 1 başlık oluşturabilirsiniz. Bu sayfanın tepesinde yer alan başlık bu şekilde oluşturulmuştur:

# Markdown Nedir?

Bu bölümün başlığı gibi 2. düzey bir başlık oluşturmak içinse ‘#’ karakterinden iki tanesini bir arada koyuyoruz:

## Bölüm Başlıkları

Bu ‘#’ karakterlerinin sayısını çoğaltarak en fazla 6. düzey bir başlık oluşturabilirsiniz.

Paragraflar

Yeni bir paragraf oluşturmak için arada boş bir satır bırakmanız yeterli. Bir paragrafın tamamını tek bir satırda yazabileceğiniz gibi, arada boş satır bırakmadan alt satırdan da devam edebilirsniz.

Bu bölüm şöyle yazıldı:

Yeni bir paragraf oluşturmak için arada boş bir satır bırakmanız yeterli. Bir paragrafın tamamını tek bir satırda yazabileceğiniz gibi, 
arada boş satır 
bırakmadan alt satırdan da devam edebilirsniz.

Bu bölüm şöyle yazıldı:

Kalın ve Eğik Yazı

Yıldız (*) ya da alt çizgi (_) karakterlerinden birer tane koyarak eğik, ikişer tane koyarak kalın yazı yazabilirsiniz:

Markdown ile *eğik* ve **kalın** yazmak çok kolay! İnanmazsan sen de _eğik_ ve __kalın__ 
yazmayı dene. :)

Bağlantılar

Bağlantı metnini köşeli parantez, bağlantı adresini (url) de normal parantez içine yazarak basit bağlantılar oluşturabilirsiniz:

[Muhammet Kara](https://muhammetkara.com)

Eğer okuyucularınıza tıklamak üzere oldukları bağlantı hakkında daha fazla bilgi vermek isterseniz, bağlantıya bir başlık ekleyebilirsiniz:

[Muhammet Kara](https://muhammetkara.com "Muhammet Kara'nın karalama defteri")

Bağlantı başlıkları, genellikle bağlantının üzerine farenizi getirdiğinizde ipucu metni olarak görüntülenir ve arama motorlarının bir sayfanın ne hakkında olduğunu anlamasına yardımcı olur.

Madde İmli Listeler

Her satır başına bir tire (-) ya da yıldız (*) ve ardından da bir boşluk koyun. Liste ögeleri iç içe geçebilir. Bu metin:

* Madde 1
* Madde 2
 * Madde 2a
 * Madde 2b
* Madde 3

…şu listeyi üretir:

  • Madde 1
  • Madde 2
    • Madde 2a
    • Madde 2b
  • Madde 3

Numaralı Listeler

Her satır başına bir sayı, bir nokta ve bir de boşluk koyun. Bu metin:

1. Patates kızartması
2. Ketçap
3. Mayonez

…şu listeyi üretir:

  1. Patates kızartması
  2. Ketçap
  3. Mayonez

Alıntılar

Eğer başka bir kişinin yazısından ya da konuşmasından alıntı yapacaksanız, bu alıntıyı <blockquote/> HTML etiketi içine koymanız gerekir. Bunu Markdown ile her satırın başına ‘>’ karakteri koyarak yapabilirsiniz. Bu metin:

> Benlik davasını bırak muhabbetten olma ırak, 
> sevgi ile dolsun yürek hoşgörülü olmaya bak. 
> <cite>Yunus Emre</cite>

…şu sonucu üretir:

Benlik davasını bırak muhabbetten olma ırak, sevgi ile dolsun yürek hoşgörülü olmaya bak. Yunus Emre

Daha Fazlası

Burada yazan kısa bilgilerin, Markdown ile birşeyler yazmaya başlamanıza yardımcı olmasını umuyorum. Daha fazla bilgi için ayrıntılı Markdown belgelendirmesini inceleyebilirsiniz. Sormak, düzeltmek ya da eklemek istedikleriniz olursa lütfen yorum yazmaktan çekinmeyin.

Mutlu yıllar! :)

Yararlanılan kaynaklar:
Markdown Cheat Sheet
Markdown Wikipedia Makalesi