Markdown Nedir, Markdown Nasıl Kullanılır?

Markdown Nedir?

Markdown, insanların okunaklı ve yazımı kolay düz metin biçiminde yazma amacı olan bir dil oluşturmak için, 2004 yılında John Gruber ve Aaron Swartz işbirliği ile geliştirilmiştir.

Markdown metne kalın, italik, başlık, liste, görsel vb. ekleyerek biçimlendiren bir sözdizimi veya kurallar dizisidir. Genellikle github, sitelerde ve çevrimiçi forum sayfalarında mesaj yazmak için kullanılan bu işaretleme dili ile zengin içerikli metinler hazırlayabilirsiniz. Markdown dosya uzantısı .md ve .markdown olarak bilinir.

En sade tanımıyla Markdown yazıyı html'e çevirmemizi (text-to-html) sağlar.

Markdown Nasıl Kullanılır?

Markdown metni biçimlendirmek için basit etiketler kullanır. Örneğin, HTML dilindeki h1 etiketinin karşılığı # olarak belirlenmiştir. Markdown ile yapabileceklerimize dair diğer örneklere göz atalım.

Başlıklar

Metinlerdeki en önemli kısımlardan biri olan başlıkları # işaretini kullanarak aşağıdaki gibi oluşturulabilir. Başlıkların boyutu # işaretinin sayısı ile belirlenir. En büyük başlık için 1, en küçük başlık boyutu içinse 6 # kullanılır.

# Başlık 1
## Başlık 2
### Başlık 3
#### Başlık 4
##### Başlık 5
###### Başlık 6

Paragraf

Markdown'da paragraf için özel tanımlı bir etiket bulunmamaktadır. Dosya içerisinde işaretsiz olarak yazılan tüm yazılar paragraf olarak kabul edilir.

Merhaba dünya!

Metin Biçimlendirme

**Kalın yazı**

_italik yazı_

__altı çizili yazı__

Resim Ekleme

Markdown kullanarak resim ekleme işlemi aşağıda bulunan örnekteki gibidir. Alt değeri opsiyonel olduğu için kare parentezin içerisi boş bırakılabilir.

![alt değeri](resim yolu)

![Kapak Görseli](https://beratkirdar.com/uploads/posts/original-markdown-nedir-markdown-nasil-kullanilir.webp)

veya

![](resim yolu)

![](https://beratkirdar.com/uploads/posts/original-markdown-nedir-markdown-nasil-kullanilir.webp)

şeklinde yazılabilir.

Liste Oluşturma

Markdown'da listeler HTML de olduğu gibi sıralı(<ul>) ve sırasız(<ol>) olmak üzere iki şekilde oluşturulabilir. Alt liste oluşturmak için ilgili maddenin altında tab(4 boşluk) bırakarak alt liste oluşturulabilir.

Sıralı liste oluşturmak için metinin satır başına 1., 2., 3., gibi düzenli olarak sayıları yazarak oluşturulabilir.

1. Madde 1
2. Madde 2
3. Madde 3

Sırasız liste oluşturmak için metinin satır başına + veya - işareti yazarak oluşturulabilir.

- Madde 1
- Madde 2
    + Madde 2.1
    + Madde 2.2
- Madde 3

Bağlantı(Link) Ekleme

Bağlantı tanımlarken tıklanacak metni kare parentezler içerisine, bağlantıyıda normal parantezler içerisine yazarak oluşturulabilir.

[Bağlantı Metni](Bağlantı adresi)

[Bağlantı Metni](https://beratkirdar.com)

Kod Bloğu Ekleme

Metne tek satırlı kod, çok satırlı kod ve dil tanımlı kodlar eklenebilir. Bir kod bloğu eklemek için aşağıdaki örnekteki gibi ters tırnak işareti kullanılır. Kodlar ters tırnaklar arasına yazılır.

Tek satırlı kod 2 adet ters virgül arasına yazılır.

` echo "Merhaba" `

Çok satırlı kodlar ise 6 adet ters virgül arasına yazılır.

```
function selam_ver(){
    return "Selam!";
}
```

Dil tanımlı kodlar eklemek için aşağıdaki örnekteki gibi ilk 3 ters virgülden sonra dil belirtilir. Ardından kodlar yazılır.

```php
<?php
     echo "Dil tanımlı kod bloğu.";
?>
```

Tablo Oluşturma

Markdown ile tablo oluşturuken tıpkı bir tablo çizer gibi düz çizgi ve tirelerden faydalanırız. Aşağıdaki örnekte olduğu gibi kolayca tablo oluşturulabilir.

| Kolon 1 | Kolon 2 | Kolon 3 |
| ------- | ------- | ------- |
| Satır   | Satır   | Satır   |
| Satır   | Satır   | Satır   |

Ayraçlar

Metini bölümlere ayırmak için ayraçları kullanabilirsiniz. Yan yana 3 adet tire koyarak ayraç oluşturulabilir.

---

Alıntılar

Metin içerisindeki alıntı içeriği göstermek için satır başına > işareti eklenir.

> Alıntı metin örneği.

Bu yazımızda markdown nedir ve markdown nasıl kullanılır bunlara değindik. Siz de bu listeye ekleme yapılmasını istediğiniz özellikleri yorumda belirtebilirsiniz. Dilerseniz benimle iletişime geçebilirsiniz.