2004 Yılında John Gruber ve Aaron Swartz tarafından geliştirilen Markdown bir yazım formatıdır. En basit tanımıyla text-to-HTML yani yazıyı HTML'e çevirmenizi sağlar.
Markdownla yazarken herhangi bir HTML etiketini kullanmaya gerek yoktur, Markdown syntaxına uygun olarak yazmak yeterlidir.
Öncelikle bir Markdown editörüne ihtiyacımız var, bizim tavsiyemiz Typora. Editörü kurduysak başlayabiliriz.
GitHub Markdown sistemine tamamen entegredir, bir klasöre tıkladığınızda o klasörün "readme.md" dosyası otomatik olarak açılır.
Cümlenin başına "#" işareti koymak başlık anlamına gelir.
# 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 metni bir Markdown editoründe önizleseydik aşağıdaki gibi gözükecekti.
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.
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ı
kod
buraya
gelecek
```
İstenilen dilin adını vererek o dile özgü renklenmeden faydalanabiliriz. Örneğin java için:
```java
public static void main(String[] args) {
// create a singly linked list to store Character elements
SinglyLinkedListGeneric<Character> myList = new SinglyLinkedListGeneric<>();
// add some elements to (the end of) the list
myList.addLast('A');
myList.addLast('B');
myList.addLast('C');
myList.addLast('D');
}
}
```
Önizleme:
public static void main(String[] args) {
// create a singly linked list to store Character elements
SinglyLinkedListGeneric<Character> myList = new SinglyLinkedListGeneric<>();
// add some elements to (the end of) the list
myList.addLast('A');
myList.addLast('B');
myList.addLast('C');
myList.addLast('D');
}
}
- liste 1
- liste 2
- liste 3
- liste 1
- liste 2
- liste 3
1. test
2. test 2
1. test 2.1
2. test 2.2
3. test 2.3
3. test 3
- test
- test 2
- test 2.1
- test 2.2
- test 2.3
- test 3
[bu linke tıkla](https://kodluyoruz.org)
Her klasörün altına "figures" isminde bir klasör açıyoruz, ilgili readme dosyasındaki her fotoğrafı buradan çekiyoruz.
Resim yüklemek aslında az önce bahsettiğimiz "Bağlantı" kısmıyla aynı şeyler, ancak bu bağlantının başına ! işareti koyarsak markdown bunun bir fotoğraf olduğunu anlıyor.
![alt değeri](input url)
![İlk Fotoğraf](figures/ilk-fotoğraf.png)
Metnin başına ">" işareti koymak alıntı haline getirir
> bu alan ve
> bu alan alıntı içeriği temsil ediyor
bu alan ve bu alan alıntı içeriği temsil ediyor
Tabloların gösterimi biraz karışık görünse de birkaç kez denedikten sonra hızlıca yapılabiliyor.
Başlık | Diğer Başlık
-- | --
Değer 1 | Değer 2
Değer 1 | Değer 2
Başlık | Diğer Başlık |
---|---|
Değer 1 | Değer 2 |
Değer 1 | Değer 2 |
Markdown'a video yüklemek tam olarak mümkün olmasa da bir fotoğrafa link göstererek video ekleyebiliyoruz. Nasıl mı yani?
Önce bir fotoğraf oluşturalım
![İsim](figures/ilk-fotoğraf.png)
oluşturduğumuz bu fotoğrafı kullanarak bir link oluşturalım
[![İsim](figures/ilk-fotoğraf.png)](https://youtu.be/Yq6u6Z1yuco)