## Referans

GitHub Markdown Uyarıları

Mart 2026'da yayınlandı

GitHub, GitHub Flavored Markdown'a uyarı (alert) söz dizimi ekledi. Bu stillendirilmiş kutular, dokümantasyondaki önemli bilgileri vurgular — notlar, ipuçları, uyarılar ve daha fazlası. ShowMeMyMD bunları render eden az sayıdaki masaüstü görüntüleyicisinden biridir.

## Söz Dizimi

Beş uyarı türü

Uyarılar, ilk satırda özel bir etiket bulunan alıntı bloku söz dizimini kullanır. Biçim her zaman aynıdır: > [!TÜR] ardından içeriğiniz sonraki satırda, yine > ile başlar.

> [!NOTE]
> Kullanıcıların içeriği göz gezdirirken bile
> bilmesi gereken faydalı bilgiler.

NOTE — Mavi bilgi kutusu olarak render edilir. Yardımcı ama kritik olmayan ek bağlam için kullanın. 'Bu arada' bilgisi düşünün.

> [!TIP]
> İşleri daha iyi veya daha kolay yapmak
> için faydalı tavsiyeler.

TIP — Yeşil öneri kutusu olarak render edilir. En iyi uygulamalar, kısayollar veya okuyucunun hayatını kolaylaştıran öneriler için kullanın.

> [!IMPORTANT]
> Kullanıcıların hedeflerine ulaşmak için
> bilmesi gereken temel bilgiler.

IMPORTANT — Mor vurgu kutusu olarak render edilir. Devam etmeden önce anlaşılması kritik olan bilgiler için kullanın. Uyarı değil, ama atlayamayacağınız bir şey.

> [!WARNING]
> Sorunlardan kaçınmak için kullanıcının
> acil dikkatini gerektiren bilgiler.

WARNING — Sarı uyarı kutusu olarak render edilir. Potansiyel sorunlar, tuzaklar veya okuyucu dikkatli olmazsa ters gidebilecek şeyler için kullanın.

> [!CAUTION]
> Belirli eylemlerin riskleri veya olumsuz
> sonuçları hakkında uyarılar.

CAUTION — Kırmızı tehlike kutusu olarak render edilir. Geri dönülemez işlemler, veri kaybı senaryoları veya bir şeyleri bozabilecek eylemler için saklayın.

## Kullanım İpuçları

Etkili uyarılar yazma

Az kullanın

Çok fazla uyarı görsel gürültü yaratır. Her şey önemliyse, hiçbir şey önemli değildir. Renkli kutularla dolu bir sayfa, okuyucuları onları görmezden gelmeye alıştırır. Bölüm başına bir veya iki genellikle doğru miktardır.

Türü ciddiyetle eşleştirin

Küçük bir ipucu için CAUTION kullanmayın. Veritabanı silebilecek bir şey için NOTE kullanmayın. Renk kodlaması, okuyuculara ciddiyet hakkında anlık bir sinyal vermek için vardır — buna saygı duyun.

İçeriği kısa tutun

Uyarılar bir ila üç cümle ile en iyi şekilde çalışır. Birden fazla paragraf gerekiyorsa, bilgi muhtemelen uyarı kutusuna değil ana gövde metnine aittir.

Diğer öğeleri iç içe koyabilirsiniz

Kod span'ları, bağlantılar, kalın ve italik uyarılar içinde çalışır. İçeriği uyarı bloğu içinde tutmak için her satırı > ile başlatın.

## Uyumluluk

Uyarıların render edildiği yerler

Araç	Uyarı Desteği
GitHub (web)	Tam — simgeli renkli kutular
ShowMeMyMD	Tam — masaüstünde stillendirilmiş uyarılar
Bazı VS Code uzantıları	Uzantıya göre değişir
Diğer birçok markdown görüntüleyici	Hayır — düz alıntı bloku gösterir
Standart CommonMark render edici	Hayır — düz alıntı bloku
Eski GFM ayrıştırıcılar	Hayır — düz alıntı bloku

Çoğu markdown görüntüleyici sadece bir alıntı bloku gösterir.

ShowMeMyMD tam stillendirilmiş uyarıyı render eder — renkli kenar çubuğu, simge ve düzgün biçimlendirme — tıpkı GitHub'da göründüğü gibi. Uyarılarla README veya doküman yazıyorsanız, bunları Mac'te yerel olarak önizlemenin birkaç yolundan biridir.

## Okumaya Devam Edin

ShowMeMyMD'nin Mac için Markdown görüntüleyicisi olarak daha fazla bilgi edinin. Geliştiricilerin neden geliştirici markdown görüntüleyicisi olarak seçtiğini görün. Veya Markdown hızlı başvuru kılavuzumuzu yer imlerine ekleyin.

Uyarıları yerel olarak önizleyin

Uyarılarınızın nasıl göründüğünü kontrol etmek için GitHub'a push etmeyi bırakın. ShowMeMyMD NOTE, TIP, IMPORTANT, WARNING ve CAUTION render eder — doğrudan Mac'inizde. Mac App Store'da $2.99.