Markdown başvuru sayfası
Markdown, düz bir dosyaya biçimlendirilmiş metin yazmak için bir dizi kuraldır ve avantajı, kaynağın hiçbir şey tarafından işlenmese bile okunabilir kalmasıdır. Aşağıdaki söz dizimi ne yapmaya çalışıyor olduğunuza göre gruplandırılmış ve her satır gerçekten ürettiği HTML'yi gösterir.
Bu HTML parçaları elle yazılmamıştır. Her biri bu sitenin kendi Markdown dönüştürücüsünün gerçek çıktısı olup, her derlemede test paketi tarafından tablo ile karşılaştırılır — yani bir satır ve araç hiç anlaşmazlığa düşerse, derleme başarısız olur ve sayfa sizi yanıltmaz.
Lehçe CommonMark artı yaygın olarak kullanılan GitHub uzantılarıdır: tablolar, görev listeleri ve üstü çizgi. Dipnotlar, tanım listeleri ve yönergeler kasıtlı olarak yoktur, çünkü daha sonra dönüştürücüde hiçbir şey yapılmayan bir söz dizimini belgelemek onu atlamaktan daha kötüdür.
Vurgu ve satır içi kod
9Satır içi söz dizimi paragraflar, başlıklar, liste öğeleri ve tablo hücreleri içinde çalışır.
| Söz dizimi | Ne yaptığı | HTML üretilmiş |
|---|---|---|
| *italic* | İtalik | <p><em>italic</em></p> |
| _italic_ | İtalik, alternatif formBir kelime içinde yok sayılır, bu nedenle snake_case hayatta kalır. | <p><em>italic</em></p> |
| **bold** | Kalın | <p><strong>bold</strong></p> |
| __bold__ | Kalın, alternatif form | <p><strong>bold</strong></p> |
| ***both*** | Kalın ve italik birlikte | <p><em><strong>both</strong></em></p> |
| ~~gone~~ | Üstü çizili | <p><del>gone</del></p> |
| `code` | Satır içi kod — içindeki hiçbir şey yorumlanmaz | <p><code>code</code></p> |
| ``a ` b`` | Arka tırnak içeren satır içi kodİçinde ortaya çıktan daha fazla arka tırnak kullanın. | <p><code>a ` b</code></p> |
| \*not italic\* | Vurgu yerine gerçek yıldız | <p>*not italic*</p> |
Başlıklar
7Karma formu kullanılacak; alt çizgi formu sadece iki seviyeye ulaşır.
| Söz dizimi | Ne yaptığı | HTML üretilmiş |
|---|---|---|
| # Heading | Seviye 1 başlığı | <h1>Heading</h1> |
| ## Heading | Seviye 2 başlığı | <h2>Heading</h2> |
| ### Heading | Seviye 3 başlığı | <h3>Heading</h3> |
| ###### Heading | Seviye 6 başlığı — en derine olan | <h6>Heading</h6> |
| Heading ======= | Seviye 1 başlığı, alt çizili form | <h1>Heading</h1> |
| Heading ------- | Seviye 2 başlığı, alt çizili form | <h2>Heading</h2> |
| ## Heading ## | Sondaki karmaşıklar dekorasyon ve düşerSağdaki sayı yok sayılır; sadece soldaki seviyeyi ayarlar. | <h2>Heading</h2> |
Listeler
7İç içe geçmiş olarak iki boşluk giriniz. Maddeler arasında boş bir satır her birini bir paragraf yapar.
| Söz dizimi | Ne yaptığı | HTML üretilmiş |
|---|---|---|
| - one - two | Madde işaretli liste | <ul> <li>one</li> <li>two</li> </ul> |
| * one * two | Madde işaretli liste, alternatif işaret | <ul> <li>one</li> <li>two</li> </ul> |
| 1. one 2. two | Numaralı liste | <ol> <li>one</li> <li>two</li> </ol> |
| 1. one 1. two | Ayrıca numaralı bir liste, işlemde yeniden numaralandırılanSadece ilk sayı kullanılır; geri kalan hepsi 1 olabilir. | <ol> <li>one</li> <li>two</li> </ol> |
| - one - nested | İç içe geçmiş liste — çocuğu iki boşluk ile giriniz | <ul> <li>one <ul> <li>nested</li> </ul></li> </ul> |
| - [ ] todo | İşaretlenmemiş görev listesi öğesi | <ul> <li><input type="checkbox" disabled /> todo</li> </ul> |
| - [x] done | İşaretli görev listesi öğesi | <ul> <li><input type="checkbox" checked disabled /> done</li> </ul> |
Bağlantılar ve resimler
6| Söz dizimi | Ne yaptığı | HTML üretilmiş |
|---|---|---|
| [text](https://a.co) | Bağlantı | <p><a href="https://a.co">text</a></p> |
| [text](https://a.co "Tip") | Araç ipucu başlığıyla bağlantı | <p><a href="https://a.co" title="Tip">text</a></p> |
| <https://a.co> | Adi URL bağlantıya dönüştürülmüş | <p><a href="https://a.co">https://a.co</a></p> |
| [mail](mailto:[email protected]) | E-posta bağlantısı | <p><a href="mailto:[email protected]">mail</a></p> |
|  | Resim, alt metin ile | <p><img src="cat.png" alt="alt" /></p> |
| [x](javascript:alert(1)) | Güvenli olmayan şema — bağlantı düşer, metin kalırjavascript:, data: ve vbscript: URL'ler href'lerini kaybeder. | <p>x</p> |
Blok elemanları
9Her biri satırın başında başlamalıdır.
| Söz dizimi | Ne yaptığı | HTML üretilmiş |
|---|---|---|
| > quoted | Alıntı | <blockquote> <p>quoted</p> </blockquote> |
| > > deeper | İç içe geçmiş alıntı | <blockquote> <blockquote> <p>deeper</p> </blockquote> </blockquote> |
| ``` code ``` | Çitlenmiş kod bloğu | <pre><code>code </code></pre> |
| ```js let a = 1; ``` | Dil sınıfı ile vurgulama için çit yapılmış kod bloğu | <pre><code class="language-js">let a = 1; </code></pre> |
| code | Dört boşluk girintiyle kod bloğu | <pre><code>code </code></pre> |
| --- | Yatay kural | <hr /> |
| *** | Yatay kural, alternatif form | <hr /> |
| one two | Paragraf içinde satır sonuİki sondaki boşluk. Çoğu editörde görünmez, bu nedenle çoğu zaman başarısız olur. | <p>one<br /> two</p> |
| one two | Boş bir satır paragrafları ayırır | <p>one</p> <p>two</p> |
Tablolar
4Sınır satırı onu bir tablo yapar. Hizalama o satırda iki nokta üst üste tarafından ayarlanır.
| Söz dizimi | Ne yaptığı | HTML üretilmiş |
|---|---|---|
| | a | b | | - | - | | 1 | 2 | | Tablo — başlık, sınır satırı, sonra gövde satırları | |
| | :--- | | Sütunu sınır satırında sola hizalayın | |
| | :---: | | Sütunu merkeze hizalayın | |
| | ---: | | Sütunu sağa hizalayın |