Temeller tek tabloda
Markdown, bir metin dosyası dönüştürülmeden önce bile okunabilir kalsın diye tasarlandı. Başlık diyez işaretiyle başladığı için başlık gibi görünür, liste de her satırı kısa çizgiyle başladığı için liste gibi görünür. Metin GitHub'da, bir not uygulamasında ya da aşağıdaki editörde gösterildiğinde işaretler gerçek biçimlendirmeye dönüşür.
Tablo en sık ihtiyaç duyacağın işaretleri kapsar. Neye dönüştüğünü görmek için herhangi bir örneği editöre kopyala.
| Öğe | Yazılışı | Sonuç |
|---|---|---|
| 1'den 6'ya başlık seviyeleri | # Başlık, ## Bölüm, ### Alt bölüm | Giderek küçülen başlıklar |
| Kalın | **kalın** ya da __kalın__ | kalın yazı |
| İtalik | *italik* ya da _italik_ | italik yazı |
| Kalın ve italik | ***ikisi*** | kalın italik yazı |
| Üstü çizili | ~~eski fiyat~~ | üstü çizili yazı |
| Satır içi kod | `npm install` | eş aralıklı kod |
| Bağlantı | [Anyfeat](https://anyfeat.com) | tıklanabilir metin |
| Görsel |  | alternatif metinli bir görsel |
| Madde işaretli liste | - madde (ya da * madde, + madde) | bir madde işareti |
| Numaralı liste | 1. birinci | numaralı bir madde |
| Görev listesi | - [ ] yapılacak ve - [x] bitti | onay kutuları |
| Alıntı | > alıntı metni | içeriden başlayan bir alıntı |
| Yatay çizgi | tek başına bir satırda *** | ayırıcı bir çizgi |
Burada dene: Markdown editörü
Aracın tam sayfasını açBaşlıklar, paragraflar ve satır sonları
Başlık yapmak için satıra birden altıya kadar diyez işareti ve bir boşlukla başla; diyez sayısı başlığın seviyesidir. Çoğu belge, başlık için bir tane 1. seviye, bölümler için 2. ve 3. seviye başlıklar kullanır. En sık yapılan hata diyezden sonraki boşluğu unutmaktır: #Başlık GitHub'da düz metin olarak kalır.
Paragraf, bir sonraki paragraftan boş bir satırla ayrılan bir ya da daha fazla metin satırıdır. Paragraf içindeki tek bir satır sonu dönüştürmede yok sayılır ve bu birçok kişiyi şaşırtır. Satırı zorla alt satıra geçirmek için satırı iki boşlukla ya da ters eğik çizgiyle bitir. GitHub yorumları ve bazı sohbet uygulamaları her satır sonunu yeni satır sayar; yukarıdaki editörde aynı davranış için GitHub yorumlarındaki gibi satır sonları ayarını aç.
GitHub'da ve yukarıdaki editörde her başlık ayrıca bir bağlantı kimliği alır: metninin küçük harfli, boşlukları kısa çizgiye çevrilmiş hali. Başlarken adlı bir başlığa [başlangıç bölümüne bak](#başlarken) şeklinde bağlantı verilebilir; README dosyalarındaki içindekiler tabloları da böyle çalışır.
Listeler ve görev listeleri
Madde işaretli listelerde her satır kısa çizgi, yıldız ya da artı işareti ve bir boşlukla başlar. Numaralı listelerde bir sayı ve nokta kullanılır. Sayıların doğru olması gerekmez: 1. 1. 1. diye yazılmış bir liste yine 1, 2, 3 olarak görünür; ama ilk sayı önemlidir, 3. ile başlayan bir liste 3'ten başlar.
Bir listeyi iç içe yapmak için iç maddeleri, üstteki maddenin metniyle hizalanacak şekilde içeri al; yani kısa çizginin altında iki, 1. altında üç boşluk. Çoğu araçta dört boşluk da çalışır. Maddeler arasındaki boş satır, maddeler arasında daha fazla boşluk olan gevşek bir liste oluşturur; boş satır yoksa liste sıkışık kalır.
Görev listeleri bir GitHub eklemesidir: açık bir görev için - [ ], bitmiş bir görev için - [x] yaz. Bunlar onay kutusuna dönüşür. Bu sayfadaki editörde önizlemedeki bir onay kutusunu işaretleyebilirsin, metnindeki [ ] da [x] olur.
Bağlantılar, görseller ve referanslar
Bağlantı, köşeli parantez içinde görünen metin ve ardından normal parantez içinde adrestir: [Anyfeat](https://anyfeat.com). Fareyle üzerine gelince görünen başlık, adresten sonra tırnak içine yazılır. <https://anyfeat.com> gibi açılı parantez içindeki bir adres, adresin kendisini gösteren bir bağlantıya dönüşür; GitHub'da https:// ya da www. ile başlayan düz adresler de kendiliğinden bağlantı olur.
Görseller aynı kalıbı başta bir ünlem işaretiyle kullanır: . Köşeli parantezdeki metin, ekran okuyucuların okuduğu ve görsel yüklenemediğinde gösterilen alternatif metindir; bu yüzden görselde ne olduğunu anlat.
Uzun belgelerde referans bağlantıları metni okunur tutar: metne [rehber][1] yaz ve dosyanın herhangi bir yerine, kendi satırına [1]: https://example.com koy. Tanım satırının kendisi sonuçta görünmez.
Tablolar
Tablolar GitHub Flavored Markdown'ın parçasıdır; GitHub, GitLab, çoğu dokümantasyon aracı ve yukarıdaki editörde çalışır ama her Markdown uygulamasında değil. Başlık hücrelerini dikey çizgilerle ayırarak yaz, sonra kısa çizgilerden oluşan bir ayırıcı satır, sonra her satır için bir satır:
| Paket | Fiyat |, sonra |:-|-:|, sonra | Ekip | 49 |. Ayırıcı satırın her hücresinde en az bir kısa çizgi olmalı; okunması kolay olduğu için genelde üç tane kullanılır. Kısa çizgilerin solundaki iki nokta sütunu sola hizalar, iki yandaki iki nokta ortalar, sağdaki iki nokta ise sağa hizalar; bu sayılara uygundur.
Dikey çizgilerin alt alta gelmesi gerekmez, dıştaki çizgiler de isteğe bağlıdır. Hücre içine dikey çizgi koymak için \| yaz. Markdown'ın kendisinde hücre içinde satır sonu olmaz; HTML'ye izin verilen yerlerde <br> kullan. Editördeki Tablo düğmesi, doldurabileceğin üç sütunlu hazır bir tablo ekler.
Kod ve alıntılar
Cümle içindeki kısa bir kod parçası için onu tek ters tırnaklar arasına al: `git status`. Birkaç satır için kodun önceki ve sonraki satırına üç ters tırnak koy. Açılış ters tırnaklarından hemen sonra yazılan js, python ya da sql gibi bir dil adı, GitHub'ın ve renklendiricilerin kodu renklendirmesini sağlar; bu sayfadaki editör de bunu dışa aktarılan HTML'de code öğesinde sınıf olarak tutar. Dört boşlukla içeri alınmış satırlar da kod olarak gösterilir.
Kodun içindeki her şey yazıldığı gibi gösterilir; bu yüzden yıldız ve alt çizgi gibi Markdown'ın başka türlü yorumlayacağı işaretler için doğru yer burasıdır. Kodun dışında bir işareti olduğu gibi göstermek için önüne ters eğik çizgi koy: \* düz bir yıldız verir.
Alıntılar > ile başlar ve listeler, >> ile yazılan iç alıntılar dahil başka Markdown da içerebilir. Kaynak göstermek, not düşmek ve tartışmalarda yanıt vermek için kullanılır.
Markdown uygulamaları arasındaki farklar
Yukarıdaki temel sözdizimi neredeyse her yerde çalışır. Farklar eklentilerdedir: GitHub tabloları, görev listelerini, üstü çizili yazıyı, otomatik bağlantıları ve > [!NOTE] şeklinde yazılan uyarıları destekler; Obsidian çift köşeli parantezle notlar arası bağlantı ekler; bazı araçlar dipnot ve matematik formüllerini destekler. Bu sayfadaki editör tablolar, görev listeleri, üstü çizili yazı, otomatik bağlantılar ve başlık bağlantıları için GitHub'ı izler; dipnotları, matematiği ve uyarıları desteklemez.
Çoğu Markdown uygulaması biraz HTML'ye de izin verir. <br>, <sub>, <sup>, <kbd> ve <details> gibi etiketler yukarıdaki editörde çalışır; script'ler, stiller ve olay öznitelikleri ise GitHub'da olduğu gibi her zaman silinir.