İçeriğe geç

Markdown Kullanımı

Bir önceki yazımızda; Markdown Editörlerinden bahsetmiştik. Bu yazımı buradan okuyabilirsiniz. Ayrıca; Markdown nedir konusuna da değinmiştik. Bu yazımız, bir önceki yazının devamı niteliğinde olup, Markdown kullanımını detaylı olarak içerecektir.

Markdown, bir işaretleme stilidir. Bu işaretleme stili ile yazılan metinlerin çıktısı doğrudan HTML kodlarını oluşturmaktadır.

Markdown yazabilmek için bir dış kaynağa ihtiyacınız var. İlk paragrafta da belirttiğimiz gibi kullanabileceğiniz bu dış kaynakları belirtmiştik.

Son zamanlarda benim tercih ettiğim Markdown editörü; Typora. Daha öncesinde ise; Windows ortamında Haroopad ve GNU / Linux ortamında ise ReText kullanıyordum. Bu editörlerin en büyük artıları; ücretsiz olmaları ve .pdf olarak çıktı verebilmeleridir. Bunun yanı sıra zaten hepsi de .html dosya oluşturabiliyorlar.

Markdown uzantı olarak; .md kullanır.

Bizim değineceğimiz Markdown stili temel olan yazım stilidir. Github veya diğer herhangi bir kaynağın Markdown üzerinde çok farklı yaklaşımları olmakla birlikte, farklı işaret ve stilleri de eklemişler. Lakin dediğimiz gibi bu anlatacağımız stiller Markdown’ın temel stilidir ve her yerde geçerlidir.

Şimdi Markdown yazım stiline geçelim ve bu işaretleme stilini detaylı olarak görelim.

Başlık

Header yani başlık etiketleri; HTML ortamında h1, h2, h3, h4, h5 ve h6 etiketleri ile tanımlanır, bildiğiniz gibi. Markdown ortamında ise; # karakteri 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

Yukarıdaki gibi başına # işareti koyacağınız metin başlık olarak tanımlanır.

Italic

Belli bir kelimeyi vurgulamak için; italic yani yatık yazı biçimi kullanılır. HTML’de italic etiketi; <i> (veya <em>) kullanılır.

Markdown ortamında; <i> etiketine karşılık gelen işaret ise * işaretidir. Aynı zamanda _ (alt tire) işaretini de kullanabilirsiniz.

*Merhaba Dünya!*

// veya

_Merhaba Dünya!_

italic olarak yazmak istediğiniz kelime veya cümleyi * veya _ işareti ile çevrelemeniz gerekiyor.

Bold

italic gibi bold yani koyu yazım biçimi de önemli kelime veya kelime gruplarını vurgulamak için kullanılır.

HTML’de bold’un karşılığı; <b> (veya <strong>) etiketidir.

Markdown ortamında bold için kullanılan işaretleme ise ** işaretlemesidir. Aynı zamanda __ (2 alt tire)

**Merhaba Dünya!**

// veya 

__Merhaba Dünya!__

şeklindeki kullanımlarda; bold ile vurgulama yapmış olursunuz.

Alıntı

Yazınızda veya makalenizde herhangi bir kaynak olarak; alıntılama yapabilirsiniz.

HTML’de alıntı olarak belirtim için; <blockquote> (veya <q>) etiketi kullanılır

Markdown ortamında alıntılama yapmak için; > işareti kullanılır.

> Let’s go invent tomorrow rather than worrying about what happened yesterday. (Steve Jobs)

Şeklinde kullanımda, alıntılama yapmış olursunuz.

Kod

Dokümanlarınız da çok sayı da koda yer verebilirsiniz, benim gibi.

HTML’de kod için kullanılan etiket ise; <code>.

Markdown ortamında, kod için kullanılan 2 seçenek bulunmaktadır. Bunlar; satır içi kodlama ve blok kodlama.

Satır içi kodlama için:

Hello World `echo('Hello World');`!

Blok kodlama için ise;

```
<?php

echo('Hello World!');
```

Şeklindedir.

Çizgi

<hr> etiketi ile HTML’de yatay çizgi bir oluşturabilirsiniz. Aynı şeyi Markdown ile de yapabilirsiniz.

Markdown ortamında bir çizgi veya bölüm oluşturmak için; — veya === işaretlerini kullanabilirsiniz.

Hello World!
---
Merhaba Dünya!
===

Şeklinde kullanımda; yatay bir çizgi oluşacaktır.

Link

Herhangi bir sayfaya bağlantı verebilirsiniz.

HTML’de link vermek için <a> etiketi kullanılır.

Markdown ortamında, link verme işlemi ise aşağıdaki gibi yapılır.

[Bağlantı](https://linkverilecekdomain.com/sayfa)

Yukarıdaki kullanımda olduğu gibi herhangi bir web siteye link verilebilir. Bunun dışında; lokalde bulunan herhangi bir sayfaya da link verilebilir. Şöyle ki;

[Bağlantı](./dosyaadi)

Resim

Dokümanlarınızda resim kullanmak isteyebilirsiniz. Bol resim dokümanlar okuyanların ilgisini çekerler.

HTML’de resim eklemek için; <img> etiketi kullanılır.

Markdown ortamında, resim ekleme işlemi de aşağıdaki gibi olmaktadır.

![alt](resim.jpg)

alt ile belirtilen yere; resim için alternatif metin yazabilirsiniz. Yani buradaki; alt değeri <img> etiketindeki alt attribute (özellik) temsil etmektedir.

Listeler

Listeler 2’ye ayrılır. Bunlar; sıralı ve sırasız listeler. 

HTML’de sıralı listeler için; <ol> etiketi kullanılır.

Markdown ortamında ise; liste belirtmek için satırların başına, bu sırayı belirtir sayı koymanız yeterlidir. Yani;

1. Adana
2. Adıyaman
3. Afyon

// veya

1) Ankara
2) Adıyaman
3) Afyon

// veya

1- Ankara
2- Adıyaman
3- Afyon

Alt listelerde belirleyebilirsiniz. Bunun için girintileme yapmanız yeterlidir. Girintileme için 2 karakterlik (veya 4 karakter) boşluk veya <tab> tuşunu kullanabilirsiniz.

1.Adana
    1.1 Aladağ
    1.2 Ceyhan
    1.3 Çukurova

HTML’de sırasız listeler için <ol> etiketi kullanılır.

Markdown ortamında sırasız listeler birden fazla şekilde tanımlanabilir.

- Adana
- Adıyaman
- Afyon

// veya

+ Adana
+ Adıyaman
+ Afyon

// veya

* Adana
* Adıyaman
* Afyon

Sıralı listeler için konuştuğumuz alt listeler özelliği sırasız listeler için de geçerlidir.

- Adana
    - Aladağı
    - Ceyhan
    - Çukurova

Saygı ve muhabbetle!..

Bu içeriği paylaşmak ister misiniz?

İlk Yorumu Siz Yapın

Bir cevap yazın

E-posta hesabınız yayımlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir

Buradaki içeriklerin tümü kamu malıdır. Kullanılması ve paylaşılması özgürdür.