Markdown Önizleyici nedir?
Markdown, README'lerin, blog yazılarının, sohbet mesajlarının, dokümantasyonun ve ham HTML yazmadan basit, okunabilir biçimlendirme istediğiniz sayısız başka yerin arkasındaki hafif biçimlendirme sözdizimidir. Markdown düz metin olduğu için her yerde yazmak kolaydır — ancak sözdizimini hafifçe yanlış yapmak ve bunu zaten yayınladıktan sonra fark etmemek de kolaydır.
Bu önizleyici, Markdown'ınızı yazarken kaynakla yan yana render eder; böylece bir README'yi commit etmeden, bir yazıyı yayınlamadan veya biçimlendirilmiş bir mesaj göndermeden önce # sonrasında eksik bir boşluk, kapatılmamış bir kod çiti veya yukarıdaki paragraftan ayrılmamış bir liste gibi biçimlendirme hatalarını hemen yakalayabilirsiniz.
Bu Hesap Makinesi Ne Zaman Kullanılmalı
- GitHub veya GitLab README yazarken ve commit etmeden önce biçatlendirmeyi doğrulamak istediğinizde
- Blog platformu, dokümantasyon sitesi veya wiki için Markdown gönderisi taslağı hazırlarken
- Göndermeden önce Markdown e-posta veya sohbet mesajının doğru render edildiğini kontrol ederken
- Farklı biçatlendirmelerle deneyerek ve anında sonuçları görerek Markdown sözdizimini öğrenirken
- CMS veya e-posta şablonuna yapıştırmak için kısa bir Markdown snippet'ini HTML'ye dönüştürürken
- Bazı biçatlendirmelerin beklendiği gibi render edilmediği bir Markdown belgesini hata ayıklarken
Adımlar:
- Markdown'ınızı sol panele yazın veya yapıştırın.
- Render edilen HTML önizlemesinin sağda anında güncellendiğini izleyin.
- Önizleme amaçladığınızla eşleşene kadar sözdiziminizi ayarlayın.
- Sonuçtan memnun kaldığınızda tamamlanmış Markdown kaynağınızı kopyalayın.
Formül
Kullanım Alanları
- Commit etmeden önce bir GitHub veya GitLab README'sini önizleme
- Slack, Discord veya Markdown destekleyen diğer sohbet uygulamaları için biçimlendirilmiş mesajlar taslak hazırlama
- Yayınlamadan önce blog yazısı veya dokümantasyon biçimlendirmesini kontrol etme
- Deney yaparak ve anında sonuçlar görerek Markdown sözdizimini öğrenme
- Kısa bir Markdown parçacığını başka bir yere yapıştırmak için hızlıca HTML'ye dönüştürme
Temel Faydalar
- Markdown'ınızın kaynakla yan yana anında render edildiğini görün
- Herhangi bir yerde yayınlamadan önce sözdizimi hatalarını yakalayın
- Tamamen tarayıcınızda çevrimdışı çalışır — hiçbir şey yüklenmez
- Ücretsiz, kayıt gerektirmez, tipik kullanım için dosya boyutu sınırı yok
Uzman İpuçları
- Farklı Markdown ayrıştırıcıları arasında en güvenilir render için listelerden ve kod bloklarından önce ve sonra boş bir satır ekleyin
- Belirsizlikten kaçınmak için kalın için çift yıldız, italik için tek yıldız (veya alt çizgi) kullanın
- Önce bu araçta önizleyin, ardından hedef platformu (GitHub, Slack vb.) kontrol edin, çünkü bazıları tablolar gibi ekstra sözdizimini destekler
- Daha iyi belge yapısı ve erişilebilirlik için başlıkları sıralı tutun (#'ten ###'e atlamayın)
Kaçınılması Gereken Yaygın Hatalar
- Bir paragraf ile onu izleyen bir liste arasında gerekli olan boş satırı unutmak
- Başlıklarda # sembollerinden sonraki boşluğu eksik bırakmak, bu da render edilmelerini engeller
- Bir kod çitini (```) kapatılmamış bırakmak; bu, belgenin geri kalanını kod olarak yutar
- Kalın için çift yıldız yerine tek yıldız kullanmak, bunun yerine italik üretmek
Anahtar Terimler Açıklandı
- CommonMark: Tutarsızlıkları azaltmak için tasarlanmış, standartlaştırılmış bir Markdown sözdizimi spesifikasyonu
- GFM: Tabloları ve görev listelerini destekleyen genişletilmiş bir lehçe olan GitHub-Flavored Markdown
- Kod çiti: Çok satırlı kodu biçimlendirmek için kullanılan, üçlü ters tırnakla (```) sınırlandırılmış bir blok
- Satır içi biçimlendirme: Blok düzeyindeki öğelerin aksine, *italik* veya `kod` gibi tek bir satır içinde uygulanan biçimlendirme
İlgili Kavramlar
- JSON biçimlendirici:
- Regex test cihazı:
- Şifre oluşturucu:
- Renk dönüştürücü:
- URL şifreleyici/çözücü:
Örnek
"## Merhaba
Bu **kalın** ve bu *italik*." yazmak, kalın ve italik metin içeren bir paragrafın ardından gelen 2. seviye bir başlık olarak render edilir.
Sonuçlarınızı Yorumlama
Sol panel ham Markdown kaynak metninizi gösterir, sağ panel ise onu gerçek zamanlı olarak biçimlendirilmiş HTML olarak render eder. Her tuş vuruşu önizlemeyi anında günceller, böylece her sözdizimi öğesinin etkisini hemen görebilirsiniz.
Yaygın render sorunları genellikle boşluk kullanımından kaynaklanır. Çoğu render edici, bir paragraf ile onu takip eden liste arasında boş bir satır gerektirir. Başlıklarda # sembollerinden sonra bir boşluk gerekir. Kod çitleri (```) kod bloğu renderini tetiklemek için kendi satırlarında olmalıdır.
Önizleme, Markdown'ınızın çoğu platformda (GitHub, Slack, Discord vb.) nasıl görüneceğine yakın bir tahmindir, ancak her platformun küçük farklılıkları olan kendi render edicisi vardır. Temel biçimlendirmenin ötesindeki her şey için hedef platformda her zaman son bir kontrol yapın.