Markdown Önizleme: Markdown’ı HTML’ye Dönüştürün
Markdown, John Gruber tarafından 2004 yılında oluşturulmuş hafif bir işaretleme dilidir. # ile başlıklar, ** ile kalın ve - ile listeler gibi basit biçimlendirme işaretçileri kullanarak düz metin yazar ve bir ayrıştırıcı bunu HTML’ye dönüştürür. Bu araç, GFM uyumlu bir ayrıştırıcı kullanarak Markdown’ınızı gerçek zamanlı render eder.
Nasıl Kullanılır
- Markdown’ı soldaki editöre yazın veya yapıştırın
- Sağdaki HTML önizlemenin gerçek zamanlı güncellendiğini görün
- Araç çubuğunu kullanarak Bölünmüş, Editör ve Önizleme görünümleri arasında geçiş yapın
- HTML Kopyala butonuna tıklayarak HTML çıktısını panonuza alın
- Örnek belge yüklemek için Örnek butonunu kullanın
GitHub Flavored Markdown (GFM)
Standart Markdown temelleri kapsar: başlıklar, kalın, italik, bağlantılar, görseller, listeler, kod blokları ve alıntılar. GFM, bunu geliştiricilerin günlük kullandığı özelliklerle genişletir.
Tablolar
Pipe ile ayrılmış tablolar, başlıklar ve hizalama ile render edilir. Ayırıcı satırındaki iki nokta üst üste işaretleri sütun hizalamasını kontrol eder: :--- sola, :---: ortaya, ---: sağa. Tablolar bir GFM uzantısıdır; orijinal Markdown veya CommonMark spesifikasyonunun parçası değildir.
Görev Listeleri
- [ ] veya - [x] ile başlayan satırlar onay kutusu olarak render edilir. GitHub bunları issue ve pull request’lerde ilerlemeyi takip etmek için kullanır. Bu önizlemedeki onay kutuları yalnızca görseldir, tıklanabilir değildir.
Çitle Çevrili Kod Blokları
Üç ters tırnak bir kod bloğu açar. Açılış ters tırnaklarından sonra bir dil tanımlayıcısı ekleyin (javascript veya python gibi) ve blok sözdizimi vurgulaması için işaretlenir. Önizleme, kod bloklarını tek aralıklı yazı tipi ve belirgin bir arka planla görüntüler.
Üstü Çizili Metin
Metni çift tilde (~~böyle~~) arasına alarak üstü çizili render edin. Kullanımdan kaldırılmış bilgileri işaretlemek veya belge revizyonunda neyin değiştiğini göstermek için kullanışlıdır.
Markdown Pratikte
Çoğu geliştirici dokümantasyonu Markdown’da yaşar: README dosyaları, wiki’ler, API dökümanları, blog yazıları ve değişiklik günlükleri. GitHub, GitLab, Notion, Obsidian ve Jekyll gibi platformların tümü Markdown’ı birincil yazma formatı olarak kullanır ancak her biri farklı uzantılar ekler.
Belirli bir platform için Markdown yazarken dikkat edilmesi gereken ana farklılıklar: HTML blok işleme (bazı platformlar ham HTML’yi kaldırır), emoji kısa kod desteği (:rocket: vs Unicode) ve matematik render etme ($ sınırlayıcıları ile LaTeX). Bu araç, geliştirici kullanım durumlarının çoğunluğunu kapsayan GFM’ye odaklanır.
Bir belgenin iki versiyonunu karşılaştırmanız mı gerekiyor? İkisini de Diff Karşılaştırıcı’ya yapıştırın. Markdown’ınızdaki yapılandırılmış verilerle mi çalışıyorsunuz? JSON kod bloklarını JSON Biçimlendirici ile doğrulayın. Dokümanlarınızdaki SQL veya HTML parçacıklarını mı biçimlendireceksiniz? Önce Kod Biçimlendirici ile temizleyin.