Github projelerinize README.MD dosyaları oluşturmak istiyor fakat Markdown işaretleme dilini bilmiyor ve bir rehbere mi ihtiyacınız var? Sizler için Markdown nedir? nasıl kullanılır? Neler yapılabilir Türkçe bir rehber hazırladık.
Markdown Nedir ?
Markdown, John Gruber ve Aaron Swartz tarafından 2004 yılında geliştirilmiş ve bu yana github, forum ve sitelerde kullanılan zengin bir işaretleme dilidir. HTML destekli bu işaretleme dili ile zengin metinler oluşturabilirsiniz. Markdown uzantisi .md
ve .markdown
olarak bilinir. Şimdi gelin markdown ile neler yapabilir öğrenelim.
📌 Başlık Ekleme
Oluşturacağımız metinlerin olmazsa olmazı olan başlıklar aşağıdaki yöntemler ile oluşturabilirsiniz. Başlıklarda önemli olan tek nokta # işaretinin sayısıdır. Ne kadar fazla # işareti var ise başlığın boyutu o kadar küçülecektir.
# Başlık1
## Başlık2
### Başlık3
Linkli Başlık eklemek içinde önce köşeli parantez içine metnimizi sonra tırnak paranterz içine link adresini eklememiz yeterli.
# [Başlık](https://www.yazilimturkiye.com/)
📌 Resim Ekleme
Resim eklemek için birden fazla yöntem bulunmakta, aşağıda en sık kullanılan 2 yöntem gösterilmekte.
Birinci yöntem; markdown dilini kullanarak görsel ekleme.
![](https://www.yazilimturkiye.com/wp-content/uploads/2021/06/yenilogo.jpg)
İkinci yöntem; HTML kullanarak resim ekleme. Bu yöntemde resmi hem ortalamış hemde boyutunu kendimiz ayarlamış olduk, yani kontrol bizde.
<p align="center">
<img width="250" height="250" src="https://www.yazilimturkiye.com/wp-content/uploads/2021/06/yenilogo.jpg">
</p>
📌 Liste Oluşturmak
Liste oluşturmak tıpkı HTML işaretleme dilinde olduğu gibi sıralı ve sırasız şeklinde 2 tiptir. Burada önemli olan başlarına koyacağınız işarettir.
Sıralı Liste; oluşturmak için metinin başına 1., 2., 3., gibi düzenli olarak sayıları sıralamamız yeterli.
1. Liste
2. Liste
3. Liste
Sırasız Liste; oluşturmak için tek yapmamız gereken listemizin başına + işaretini koymaktır.
+ Liste 1
+ Liste 2
+ Liste 3
+ Liste 3.1
+ Listes 3.2
Sırasız Liste 2; burada da tıpkı diğer örnekteki gibi tek yapmamız gereken başına – işaretini koymaktır. Genelde en çok kullanılan liste tipi budur.
- Liste 1
- Liste 2
- Liste 3
- Liste 3.1
- Liste 3.2
📌 Link Ekleme
Markdown ile neredeyse her şeye link verebilirsiniz. Link verir iken [] köşeli parantez içine metnimizi daha sonrada tırnak parantez () içine de link adresi verilir. Link vermek için yapmanız gerekenler aşağıdadır.
[YazılımTürkiye](https://www.yazilimturkiye.com/)
📌 Kod Satırı Ekleme
Metinlerinize kod kutucuğu eklemek için ters virgül kullanabilirsiniz. Kodlarınızı Ters virgül içine yazmanız gerekmekte. Ters virgül yapmak için AltGR + Virgül tuşlarına basınız. Aşağıdaki örneği kullanabilirsiniz.
` print ('Hello World') `
Çoklu satırda kod ekleme; bunun için ilk örneğimizdeki gibi ters virgül kullanıyoruz fakat bu sefer ters virgül sayısı 3 olmalıdır.
```<!DOCTYPE html>
<html>
<head>
<title>Hello world!</title>
</head>
<body>
<h1>Hello world!</h1>
</body>
</html>
```
📌 Tablo Oluşturma
Markdown ile tablo oluşturmak hem çok zevkli hemde çok kolaydır. Tek yapmanız gereken sutunlar için düz çizgi satırlar için ise tire koymanız yeterlidir. Düz çizgi yapmak için Ctrl + Alt + Tire İşareti kompinasyonunu yapınız. Örnek Tablo aşağıdadır.
| Birinci Başlık| İkinci Başlık |
| ------------- | ---------------- |
| İçerik | İçerik |
| İçerik | İçerik |
📌 Ayraçlar
Seffat bir ayraç koymak metinlerinizin okunabilirliğini ve içeriklerin ayrılması için çok önemli olabilir. Ayraç yapmak için 3 adet tire koymanı yeterli.
---
📌 Alıntılama
Alıntı yapmak için klavyenizdeki büyüktür işaretiniz koymanız ve metnininizi yazmanız yeterli.
> Ne demişler? çalışıyorsa dokunma...
📌 Seçim Kutucukları Oluşturma
Metninizde seçim kutucukları (checkbox) kullanmak istiyor iseniz aşağıdaki yöntemler ile ekleyebilirsiniz. Burada önemli olan köşeli parantezin içine bir boşluk koymanız. Dilersenizde seçim kutularından birinin içine koyacağınız bir X karakteri ile seçili olarak gösterebilirsiniz.
[x] Masaüstü
[ ] Web
[ ] Mobil
[ ] Yapay Zeka
📌 Metinsel Geliştirmeler
Markdown kullanır iken metinlerinizi ister kalın istersenizde italik yapabilirsiniz.
**kalın yazma**
<b> kalın yazma 2 </b>
_italik_
__altı çizgili__
📌 Çevrimiçi Test Yap
Bu kodları online olarak deniyebileceğiniz bir editör mevcut. Bu editöre ulaşmak için buraya tıklanıyınız.
Markdown Nedir türkçe kullanım rehberimizi bitirdik. Sizde bu listeye ekleme yapmak için yorumlara bildiğiniz şeyleri ekleyebilirsiniz. Aramıza katılmak için telegram grubumuza gelebilirsiniz. Dilerseniz de bizimle iletişime geçebilirsiniz.