Markdown, düz-metin-biçimlendirme sözdizimine sahip hafif bir işaretleme dili. Tasarımı, birçok çıktı biçimine dönüştürülmesine izin verir, ancak aynı ada sahip orijinal araç yalnızca HTML'yi destekler. Markdown genellikle BENİOKU (README) dosyalarını biçimlendirmek, çevrimiçi tartışma forumlarına mesaj yazmak ve düz metin düzenleyicisi kullanarak zengin metin oluşturmak için kullanılır.
Markdown’un ilk tanımı belirsizlikler ve cevaplanmamış sorular içerdiğinden, yıllar boyunca ortaya çıkan uygulamaların ince farklılıkları vardır ve çoğu sözdizimi, dosya uzantılarıyla birlikte gelir.
Tarih
John Gruber, Markdown dilini 2004 yılında Aaron Swartz ile sözdiziminde işbirliği yaparak oluşturdu, insanların okuma ve yazması kolay düz metin biçimini kullanarak isteğe bağlı olarak XHTML'ye veya HTML'e dönüştürme amacını taşıyordu.
CommonMark
2012'den itibaren Jeff Atwood ve John MacFarlane dahil bir grup insan Atwood'un standartlaştırma çabası olarak nitelendirdiği şeyi başlattı. Eylül 2014'te Gruber, bu çaba adına Markdown kullanımına itiraz etti ve CommonMark adında yeni bir lehçe olarak yeniden adlandırıldı. Commonmark.org 3 Şubat 2020 tarihinde Wayback Machine sitesinde arşivlendi. çeşitli spesifikasyonlar, referans uygulaması ve test paketinin çeşitli versiyonlarını yayınlamaktadır
GitHub Flavored Markdown (GFM)
2017'de GitHub, GitHub Aromalı Markdown (GFM) için CommonMark tabanlı resmi bir şartname yayınladı. GitHub spesifikasyonunun uzantılar olarak eklediği tablolar, üstü çizili, otomatik bağlantılar ve görev listeleri dışında tam olarak CommonMark spesifikasyonunu izler. GitHub, sitelerinde kullanılan ayrıştırıcıyı da buna göre değiştirdi, bu da bazı belgelerin değiştirilmesini gerektiriyordu. Örneğin, GFM artık bir başlık oluşturan kare sembolünün başlık metninden bir boşluk karakteriyle ayrılmasını gerektirir.
Örnek
| Markdown sözdizimi | Bir Markdown işleyicisi tarafından üretilen HTML kodu (pandoc --from commonmark --to html5)
|
Bir tarayıcıda görünen metin |
|---|---|---|
Başlık ======= Alt-başlık ----------- Boşluk ile ayrılmış paragraflar. Satır sonundaki iki boşluk alt satıra geçer. Metin özelliği _italik_, **kalın**, 'eşit aralıklı'. Yatay ayraç: --- Üstü çizili: ~~üstüçizili~~ Madde imli liste: * elmalar * portakallar * üzümler Numaralı liste: 1. elma 2. armut 3. mango Bir [örnek](http://örnek.com).  > Alıntı için > karakteri kullanılır. Satır içi <abbr title="Hypertext Markup Language">HTML</abbr> desteklenir. |
<h1>Başlık</h1> <h2>Alt-başlık</h2> <p>Boşluk ile ayrılmış paragraflar.</p> <p>Satır sonundaki iki boşluk alt satıra geçer.</p> <p>Metin özelliği <em>italik</em>, <strong>kalın</strong>, <code>eşit aralıklı</code>.</p> <p>Yatay ayraç:</p> <hr /> <p>Üstü çizili: ~~üstüçizili~~</p> <p>Madde imli liste:</p> <ul> <li>elmalar</li> <li>portakallar</li> <li>üzümler</li> </ul> <p>Numaralı liste:</p> <ol> <li>elma</li> <li>armut</li> <li>mango</li> </ol> <p>Bir <a href="http://örnek.com">örnek</a>.</p> <p><img src="Icon-pictures.png" title="icon" alt="Image" /></p> <blockquote> <p>Alıntı için > karakteri kullanılır.</p> </blockquote> <p>Satır içi <abbr title="Hypertext Markup Language">HTML</abbr> desteklenir.</p> |
Başlık
Alt-başlık
Boşluk ile ayrılmış paragraflar. Satır sonundaki iki boşluk alt satıra geçer. Metin özelliği italik, kalın, Yatay ayraç: Üstü çizili:
Madde imli liste:
Numaralı liste:
Bir örnek.
Satır içi HTML desteklenir. |
