## Geliştirici İş Akışı

GitHub README.md Dosyalarını Mac'te Yerel Olarak Önizleme

Mart 2026'da yayımlandı

README'yi düzenlediniz. Şimdi push yapmadan önce nasıl göründüğünü görmek istiyorsunuz. İşte bunu yapmanın üç yolu, en ağırından en hızlısına.

## Neden Yerel Önizleme

Neden yerel olarak önizleyelim?

  • Push yapmadan önce biçimlendirmeyi kontrol edin. Bozuk tablolar, hatalı bağlantılar ve bozulmuş kod blokları herkese açık bir repoda utanç vericidir. git push'tan önce yakalayın.
  • Çevrimdışı çalışın. Uçaklar, trenler, kötü wifi'li kafeler. README'nizi incelemek için internet bağlantısı gerekmemeli.
  • PR dokümantasyon değişikliklerini inceleyin. Bir pull request README'yi güncellediğinde, kod diff'inin yanında renderlenmiş sonucu görmek istersiniz.
  • Commit-push-kontrol döngüsünden kaçının. README'nizin GitHub'da nasıl göründüğünü görmek için commit push etmek git geçmişinizi kirletir ve zaman kaybettirir.

## Yöntem 1

grip (CLI aracı)

pip install grip
grip README.md

grip, Markdown'unuzu GitHub API'sini kullanarak renderler, böylece tarayıcınızda localhost:6419'da piksel mükemmelliğinde GitHub renderlaması elde edersiniz.

Artılar

  • Tam GitHub renderlaması (API'lerini kullanır)

Eksiler

  • Python kurulu olmalı
  • Yoğun kullanım için GitHub API token'ı gerekir (aksi halde hız sınırlı)
  • Başlatıp durdurmamız gereken yerel bir sunucu çalıştırır
  • Çevrimdışı dostu değil (GitHub API'sini çağırır)

## Yöntem 2

VS Code yerleşik önizleme

VS Code'da README.md dosyasını açın
Cmd + Shift + V → önizleme paneli

VS Code'un yerleşik Markdown önizlemesi var. Dosyayı açın, klavye kısayolunu kullanın ve yan panelde renderlenmiş çıktı görüntülenir.

Artılar

  • Çoğu geliştirici için zaten kurulu
  • Çevrimdışı çalışır

Eksiler

  • README önizlemek için tam bir IDE başlatmak aşırı
  • Önizleme renderlaması GitHub ile tam olarak eşleşmez (callout desteği yok, farklı tablo stili)
  • Editörünüze bağlı — bir dosyaya çift tıklayamazsınız

## Yöntem 3 (Önerilen)

ShowMeMyMD — sadece çift tıklayın

git clone <repo>
README.md'ye çift tıklayın
Bitti.

ShowMeMyMD, yerel bir macOS Markdown görüntüleyicisidir. .md dosyaları için varsayılan uygulama olarak ayarlayın ve her README anında renderlenmiş önizleme olarak açılır. CLI yok. Sunucu yok. Kurulum yok.

Tam GitHub-Flavored Markdown desteği:

  • Hizalamalı tablolar
  • Onay kutulu görev listeleri
  • Söz dizimi vurgulu çitli kod blokları
  • GitHub tarzı callout'lar: NOTE, TIP, WARNING, IMPORTANT, CAUTION

Klonla, README.md'ye çift tıkla, bitti.

## Karşılaştırma

Yan yana karşılaştırma

AraçKurulumGFM DoğruluğuHızÇevrimdışı
gripPython + pip installTam (GitHub API)Yavaş (ağ)Hayır
VS CodeZaten kuruluKısmiHızlıEvet
ShowMeMyMDMac App Store'dan bir kez kurTam GFM + callout'larAnlıkEvet

## Okumaya Devam Edin

ShowMeMyMD'nin Mac için Markdown görüntüleyici olarak özellikleri hakkında daha fazla bilgi edinin. Bir geliştirici iş akışına nasıl uyduğunu görün. Ya da GitHub tarzı callout'lar rehberimizi okuyun.

README'nizi kontrol etmek için push yapmayı bırakın

Herhangi bir .md dosyasına çift tıklayın ve anında renderlenmiş olarak görün. GitHub-Flavored Markdown, söz dizimi vurgusu, dört tema. Mac App Store'da $2,99.

İndirMac App Store