Dosyalarınızı Yüklemeden Markdown Çevrim İçi Nasıl Önizlenir?

Markdown düz metin olarak okunabilecek şekilde tasarlanmıştır, ama yine de nihai belgenin nasıl göründüğünü görmek istersiniz: tablo hizalı mı, liste doğru iç içe geçmiş mi, kod bloğu renklendirilmiş mi? Canlı önizleme, işlenmiş sonucu kaynağın yanında gösterir ve her tuş vuruşunda günceller.

Bu rehber, Markdown önizlemenin yaygın yollarını karşılaştırıyor, günlük kullanımda gerçekten fark yaratan özellikleri sıralıyor ve yerel dosyaları tarayıcıda açan hızlı bir iş akışı gösteriyor — hiçbir şey kurmadan ve dosyaları bir sunucuya göndermeden.

Markdown önizlemenin üç yolu

1. Kod editörünüzün içindeki önizleme

VS Code, JetBrains IDE’leri ve diğer birçok editörde yerleşik bir Markdown önizlemesi bulunur. Zaten o editörde çalışıyorsanız iyi bir seçenektir. Dezavantajları: editörün kurulu olmasını gerektirir, matematik ve diyagramlar için çoğu zaman eklenti gerekir ve yalnızca bir README.md okumak isteyen bir iş arkadaşınıza hızlıca verebileceğiniz bir şey değildir.

2. Çevrim içi Markdown önizleyici

Solda editör, sağda önizleme bulunan bir web sitesi en hızlı seçenektir: bir sekme açın ve yazmaya başlayın. Sorun şu ki çevrim içi araçlar birbirinden çok farklıdır. Bazıları metninizi işlemek için bir sunucuya gönderir, bazıları belgeleri size söylemeden tarayıcınızda saklar, pek çoğu da yalnızca temel sözdizimini destekler — tablo yok, görev listesi yok, matematik yok.

3. Kendi sunucunuzda barındırılan önizleyici

Kendiniz barındırdığınız statik bir web uygulaması, bir web sitesinin rahatlığını tam kontrolle birleştirir: kendi alan adınızda çalışır, tüm ekibiniz için aynı görünür ve neyi yapıp neyi yapamayacağına siz karar verirsiniz. Bu seçeneği kendi Markdown editörünüzü barındırma yazısında ayrıntılı olarak ele alıyoruz.

Bir Markdown önizleyicide nelere dikkat edilmeli?

Her önizleyici aynı derecede keyifli değildir. Her gün kullanmaya başladığınızda önemli olan özellikler şunlardır:

• Anında işleme. Önizleme siz yazarken, “İşle” düğmesi ya da fark edilir bir gecikme olmadan güncellenmelidir.
• Eşzamanlı kaydırma. Uzun bir belgede önizleme editörü takip etmeli; düzenlediğiniz paragraf sağda her zaman görünür olmalıdır.
• GitHub-Flavored Markdown. Tablolar, görev listeleri, üstü çizili metin, dipnotlar ve uyarı kutuları GitHub’dakiyle aynı şekilde görüntülenmelidir. Bunların ne olduğundan emin değilseniz Markdown kopya kâğıdına göz atın.
• Kullandığınız diller için kod renklendirme.
• Teknik belge yazıyorsanız matematik ve diyagramlar: LaTeX formülleri ve Mermaid diyagramları.
• Yerel dosyaları açma. Sürükle-bırak; tek dosya, birden çok dosya ve bütün klasörler için çalışmalı — belgenin başvurduğu görseller dahil.
• Dışa aktarma. Belge bittiğinde genellikle HTML, PDF ya da temiz bir .md dosyası olarak ihtiyaç duyarsınız.
• Yerel işleme. İdeal olan, metnin tarayıcınızda işlenmesi ve bilgisayarınızdan hiç çıkmamasıdır. Bu; şirket içi belgeler, sözleşmeler, taslaklar ve notlar için önemlidir.

Markdown Preview Editor ile hızlı bir iş akışı

Markdown Preview Editor, tam da bu liste etrafında geliştirilmiş ücretsiz, açık kaynaklı bir editördür. İşte tipik bir oturum.

1. Adım: Editörü açın

Çevrim içi sürümü ya da kendi kopyanızı açın. Kayıt yok, kurulacak bir şey yok. Arayüz 15 dilde mevcuttur ve tarayıcınızın dilini otomatik olarak izler.

2. Adım: Dosyalarınızı açın

Bir .md dosyasını editörün üzerine sürükleyin — ya da aynı anda birkaç dosyayı veya bütün bir klasörü. Her belge, kendi geri alma geçmişiyle kendi sekmesinde açılır. Belgeyle birlikte bırakılan görseller, ses ve video önizlemede görünür; çünkü göreli yollar bıraktığınız klasöre göre çözülür.

Klavyeyi mi tercih edersiniz? Dosya seçmek için Ctrl+O (Mac’te ⌘O) tuşlarına basın ya da bir dizini açmak için Klasör düğmesini kullanın.

3. Adım: Önizleme yanınızdayken yazın

Soldaki editöre yazın; sağdaki önizleme anında güncellenir ve sizinle birlikte kayar. Biçimlendirme araç çubuğu başlıklar, listeler, bağlantılar, tablolar ve kod blokları ekler. Daha az kullanılan araçlar — dipnotlar, uyarı kutuları, matematik, diyagramlar — daraltılabilir Gelişmiş düzenleyici satırında durur; böylece araç çubuğu sade kalır.

Tek tıkla üç görünüm modu arasında geçiş yapın: yalnızca düzenleyici, bölünmüş görünüm ve yalnızca önizleme. Telefonda düzen otomatik olarak uyum sağlar ve araç çubuğu, ihtiyaç duyana kadar gizlenir.

4. Adım: Kaydedin veya dışa aktarın

İşiniz bittiğinde belgeyi .md olarak kaydedin, bağımsız bir HTML dosyası olarak dışa aktarın ya da PDF olarak yazdırın. Markdown’ı HTML ve PDF’e dönüştürme yazısı bu seçenekleri ayrıntılı olarak anlatıyor.

Dosyalarınız nereye gidiyor?

Birçok web aracında metninizin yüklenip yüklenmediğini anlamak kolay değildir. İşe yarar bir test: tarayıcının geliştirici araçlarını açın, Network (Ağ) sekmesine geçin ve bir şeyler yazın. Siz yazarken yeni istekler beliriyorsa metniniz sayfadan çıkıyor olabilir.

Markdown Preview Editor her şeyi tarayıcıda işler. Açtığınız dosyalar yerel olarak okunur ve ayarlarda Belgeleri hatırla seçeneğini açmadığınız sürece belgeler yalnızca açık sekmede tutulur. Belgedeki harici görseller ve bağlantılar siz izin verene kadar yüklenmez; dolayısıyla bir dosyayı açmak da başka sunuculara bağlanmaz.

Daha rahat bir önizleme için ipuçları

• Görselleri belgenin yanında tutun: bir images/ veya assets/ klasörüne koyun ve göreli yollarla bağlayın. Ardından bütün klasörü bırakın; her şey görünür.
• Dosya başına tek # başlığı kullanın. Bu başlık, dışa aktarılan HTML’in başlığı olur ve uzun belgelerde gezinmeyi kolaylaştırır.
• Belgeler üzerinde birlikte çalışırken ayarlardan satır numaralarını açın — “42. satır” gibi inceleme yorumlarını takip etmek kolaylaşır.
• Gece koyu modu kullanın. Önizleme, temayı editörle birlikte değiştirir.