Giriş yap

Markdown nedir? Nasıl kullanılır?

Prototürk'ün de soru & cevap bölümünde kullanmayı tercih ettiğimiz yazım formatı markdown hakkında biraz bilgilendirme yapmak istiyorum.

2004 yılında John Gruber ve Aaron Swartz tarafından geliştirilen bir yazım formatıdır. En basit tanımıyla text-to-HTML yani yazıyı HTML'e çevirmemizi sağlar.

Markdown formatı ile yazarken herhangi bir html etiketi yazmayız, markdown'ın syntax'ına uygun şekilde yazarız ve kulladığımız front-end ya da back-end dili ile bunu parse ederek html çıktısını alırız. Böylece yazan kişininde hata payı minimuma iner, daha okunaklı bir yazım tarzı oluşur.

Gelin html'de yazdığımız şekilde markdown'da nasıl yazarız temel olarak inceleyelim.

Başlık etiketleri

HTML'de <h1> <h2> diye oluşturduğumuz başlık etiketlerini markdown'da şöyle oluşturuyoruz.

# h1 başlık
## h2 başlık
### h3 başlık
#### h4 başlık
##### h5 başlık
###### h6 başlık

Eğer yukarıdaki yazıyı soru & cevap bölümündeki editöre yazıp önizlerseniz sonucunda şöyle bir çıktı alırsınız;

<h1>h1 başlık</h1>
<h2>h2 başlık</h2>
<h3>h3 başlık</h3>
<h4>h4 başlık</h4>
<h5>h5 başlık</h5>
<h6>h6 başlık</h6>

Paragraf

Paragraf için ekstra bir şey yapmanıza gerek yok, markdown syntax'ı kullanılan yerler hariç tamamı p etiketi olacaktır.

Kalın, Eğik, Üstü çizili ve Tek Satırlı Kod

Kalın yapmak için **bu yazı kalın olacak**, eğik yapmak için _bu yazı eğik olacak_, üstü çizik yapmak için ~~buranın üstü çizik olacak~~ ve tek satır kod için `kod buraya` şeklinde kullanabilirsiniz. Çok satırlı kodların kullanımı aşağıda, merak etmeyin.

Çok Satırlı Kod

pre ve code etiketleri içinde göstermek için kullanımı şöyledir;

```
çok
satırlı
kod
buraya
gelecek
```

özellikle bir dilin adını belirterekte kod örneği verebilirsiniz. Örneğin css için;

```css
.box {
    color: red;
}
```

css yerine diğer dillerin adını da yazarak kullanabilirsiniz. Markdown parser'ı buna göre code etiketine language-css ya da language-neyazıldıysa şeklinde otomatik class tanımlayacaktır.

Yatay Çizgi <hr>

Bölümlere ayırmak için <hr> etiketi kullanmak yerine markdown'da şu şekilde kullanıyoruz;

bir şeyler yazdık ve

---

burası iki ayrı bölüm oldu, yatay bir çizgi ile üstteki ve alttaki yazıyı böldük

Listeler

<ul> ve <li> etiket kullanmak yerine liste yapmak istersek şöyle yapabiliriz;

- liste 1
- liste 2
- liste 3

Buda bize şöyle bir çıktı verir;

<ul>
    <li>liste 1</li>
    <li>liste 2</li>
    <li>liste 3</li>
</ul>

Düzenli (sayılı) liste yapmak için ise şu formatı kullanabilirsiniz;

1. test
2. test 2
    1. test 2.1
    2. test 2.2
    3. test 2.3
3. test 3

<a> etiketi yerine markdown'da şöyle bir kullanım var;

[bu linke tıkla](https://prototurk.com)

HTML çıktısı şöyle olacak;

<a href="https://prototurk.com">bu linke tıkla</a>

Resim

Resim göstermek için kullanım şöyle;

![](https://octodex.github.com/images/yaktocat.png)

ya da

![alt değeri](https://octodex.github.com/images/yaktocat.png)

Alıntı

<blockquote> etiketini kullanmak için metnin başına > işareti koymanız yeterli.

> bu alan ve
> bu alan alıntı içeriği temsil ediyor

Tablo

Tabloları gösterirken biraz karmaşık gelebilir ancak alışınca hızlıca yapıyorsunuz :) İşte bir örneği;

Başlık | Diğer Başlık
-- | --
Değer 1 | Değer 2
Değer 1 | Değer 2

Diğer kullanımlarına ise şuradan bakabilirsiniz;
https://guides.github.com/features/mastering-markdown/