Markdown Önizleme
Markdown yazın ve HTML'yi canlı olarak önizleyin
Markdown Taslağı
Canlı Önizleme
Markdown Önizleme Nedir?
Markdown Önizleme, Markdown kaynak kodunuzun HTML'ye dönüştürüldüğünde tam olarak nasıl görüneceğini gösteren gerçek zamanlı bir render aracıdır. Bölünmüş panel arayüzüyle sol tarafta ham Markdown yazarken sağ taraf canlı, render edilmiş çıktıyı anında gösterir. Bu anlık görsel geri bildirim, Markdown biçimlendirme tahminini ortadan kaldırır — başlıkların nasıl göründüğünü, bağlantıların çalışıp çalışmadığını, kod bloklarının nasıl render edildiğini ve tablo sözdiziminin doğru olup olmadığını editörden ayrılmadan görebilirsiniz.
CommonMark, çoğu önizleme aracının takip ettiği standart Markdown spesifikasyonudur ve platformlar arasında tutarlı rendering sağlar. Bu araç CommonMark uyumlu ayrıştırma uygular. Görev listeleri, üstü çizili ve otomatik bağlantılar gibi GitHub'a özgü özellikler için önizleme GitHub Flavored Markdown uzantılarını da destekler.
Önizleme araçları, Markdown ile çalışan her içerik oluşturucu için paha biçilmezdir. Belge hazırlayan teknik yazarlar, karmaşık iç içe geçmiş listeleri ve kod bloğu biçimlendirmesini doğrulayabilir. README yazarları, özellik tablolarının doğru render edildiğinden emin olabilir. Geliştiriciler, commit mesajlarını, pull request açıklamalarını ve issue yorumlarını göndermeden önce düzgün biçimlendirebilir.
Markdown Önizleme Nasıl Kullanılır
Markdown'ı gerçek zamanlı HTML olarak önizlemek için bu adımları izleyin.
Yapıştırın, Yükleyin veya Örnek Yükleyin
Sol Markdown Taslağı paneline Markdown yazın veya yapıştırın ya da Yükle'ye tıklayarak bir .md dosyası yükleyin. Örnek API belgeleri görmek için Örnek'e tıklayın. CommonMark ve GFM'yi destekler (tablolar, görev listeleri, kod blokları).
Canlı Önizlemeyi Görün
Sağ Canlı Önizleme paneli siz yazarken güncellenir. Render edilmiş başlıkları, listeleri, tabloları ve kod bloklarını görün. Gecikme yok — anlık geri bildirim.
HTML'yi Kopyalayın veya İndirin
Çıktıyı kullanmak için HTML'yi Kopyala veya HTML'yi İndir'e tıklayın. Yeniden başlamak için Temizle'yi kullanın. Tüm işlem tarayıcınızda gerçekleşir.
Bunu Gerçekten Ne Zaman Kullanırsınız
Belge Yazma ve Düzenleme
GitHub repoları, ReadTheDocs projeleri ve MkDocs veya Hugo ile oluşturulan belge siteleri Markdown kullanır. Önizleme araçları, derleme veya dağıtım beklemeden belge oluşturmanıza ve mükemmelleştirmenize olanak tanır.
GitHub Issue ve PR Yazma
GitHub'da ayrıntılı issue'lar veya pull request açıklamaları yazarken önizleme araçları mesajınızı mükemmel biçimlendirmenizi sağlar. Göndermeden önce tabloların ve kod bloklarının doğru olduğunu kontrol edin.
Release Notları ve Changelog Oluşturma
Yazılım sürümleri, net ve iyi biçimlendirilmiş release notları gerektirir. Doğru biçimlendirme, sürüm başlıkları, özellik listeleri ve breaking change uyarılarıyla changelog'lar hazırlamak için Markdown önizlemeyi kullanın.
Sıkça Sorulan Sorular (SSS)
Önizleme, içeriğimin her yerde tam olarak nasıl render edileceğini gösteriyor mu?
Önizleme, CommonMark uyumlu ayrıştırma artı GitHub Flavored Markdown uzantıları kullanır ve içeriğinizin çoğu modern platformda nasıl görüneceğini doğru şekilde temsil eder. Ancak bazı platformların özel CSS stilleri veya ek uzantıları vardır. Tam görsel eşleşme gerekiyorsa hedef platformun belgelerine bakın.
Hangi Markdown uzantıları destekleniyor?
Bu önizleme CommonMark çekirdek sözdizimini artı GitHub Flavored Markdown uzantılarını destekler: tablolar, görev listeleri, üstü çizili (~~metin~~), otomatik bağlantılar ve mention sözdizimi.
Oluşturulan HTML'yi kopyalayabilir miyim?
Evet. Render edilmiş HTML çıktısını panonuza kopyalamak için "HTML'yi Kopyala"ya tıklayın. Ardından HTML kabul eden herhangi bir HTML düzenleyicisine, e-posta istemcisine veya web formuna yapıştırabilirsiniz.
Özel karakterler çıktıda doğru şekilde escape ediliyor mu?
Evet. Ayrıştırıcı, metin içeriğindeki özel HTML karakterlerini (&, <, >, ", ') otomatik olarak escape eder, böylece injection saldırıları ve render hataları önlenir.
Araç satır sonlarını nasıl işler?
Araç CommonMark kurallarını izler: kaynaktaki tek bir satır sonu, çıktıda bir boşluk olur. Gerçek bir satır sonu (<br>) oluşturmak için satır sonundan önce iki boşluk kullanın veya yeni satırdan önce ters eğik çizgi kullanın.
Markdown'ıma ham HTML ekleyebilir miyim?
Evet. Markdown ham HTML bloklarına ve inline HTML'ye izin verir. Markdown'ınıza doğrudan HTML yazarsanız, çıktıya olduğu gibi dahil edilir. Bu, Markdown'ın yerel olarak desteklemediği özellikler için kullanışlıdır.