Yazı Dizisi: Markdown
1. Markdown'ın Doğuşu ve Temel Felsefesi 2. Markdown Sözdizimi: Temel Yapılar 3. Markdown'ın Gelişmiş Özellikleri 4. Markdown Çeşitleri ve Farklılıkları 5. Markdown Araçları ve Ekosistem
İçindekiler
Markdown Editörleri IDE Eklentileri Dönüştürme Araçları Git Platformları için Araçlar Not Alma Uygulamaları Markdown Linting Özelleştirilmiş Çözümler En İyi Uygulamalar Sonuç

Önceki yazımızda Markdown’ın farklı çeşitlerini incelemiştik. Bu son yazımızda, Markdown ile çalışırken kullanabileceğiniz araçları ve ekosistemi keşfedeceğiz.

Markdown Editörleri

Masaüstü Editörler

Visual Studio Code

  • Ücretsiz ve açık kaynak
  • Zengin eklenti ekosistemi
  • Canlı önizleme
  • Sözdizimi vurgulama
  • Git entegrasyonu

Typora

  • Minimal ve şık arayüz
  • WYSIWYG editör
  • Gerçek zamanlı önizleme
  • Özelleştirilebilir temalar
  • Çoklu dışa aktarma seçenekleri

MacDown (macOS)

  • Ücretsiz ve açık kaynak
  • Hızlı ve hafif
  • Özelleştirilebilir önizleme
  • Sözdizimi vurgulama
  • Matematik formülü desteği

MarkText

  • Ücretsiz ve açık kaynak
  • Çoklu platform desteği
  • WYSIWYG editör
  • Dosya yönetimi
  • Tema desteği

Web Tabanlı Editörler

StackEdit

  • Tarayıcı tabanlı
  • Google Drive ve Dropbox entegrasyonu
  • Çevrimdışı çalışma
  • Gerçek zamanlı işbirliği
  • HTML ve PDF dışa aktarma

Dillinger

  • Minimal arayüz
  • Cloud desteği
  • HTML ve PDF dışa aktarma
  • GitHub entegrasyonu
  • Anlık önizleme

IDE Eklentileri

VS Code Eklentileri

  1. Markdown All in One

    • Otomatik tamamlama
    • Klavye kısayolları
    • İçindekiler tablosu oluşturma
    • Matematik formülü desteği

  2. Markdown Preview Enhanced

    • Gelişmiş önizleme
    • Çoklu dışa aktarma
    • PlantUML ve Mermaid desteği
    • Özelleştirilebilir CSS

  3. markdownlint

    • Stil kontrolü
    • Hata denetimi
    • Otomatik düzeltme
    • Özelleştirilebilir kurallar

JetBrains IDE’leri için Eklentiler

  1. Markdown Navigator Enhanced
    • Zengin düzenleme özellikleri
    • Canlı önizleme
    • Jira ve GitHub entegrasyonu
    • Özelleştirilebilir temalar

Dönüştürme Araçları

Pandoc

En güçlü dönüştürme aracı:

# Markdown'dan PDF'e
pandoc dosya.md -o cikti.pdf

# Markdown'dan Word'e
pandoc dosya.md -o cikti.docx

# HTML'den Markdown'a
pandoc -f html -t markdown dosya.html -o cikti.md

Jekyll

Blog ve statik site oluşturma:

# Yeni site oluşturma
jekyll new site-adi

# Yerel sunucuda çalıştırma
jekyll serve

MkDocs

Teknik dokümantasyon oluşturma:

# Yeni proje oluşturma
mkdocs new proje-adi

# Yerel sunucuda çalıştırma
mkdocs serve

Git Platformları için Araçlar

GitHub

  • README önizleme
  • Wiki desteği
  • Issue ve PR şablonları
  • GitHub Pages

GitLab

  • Wiki sistemi
  • Dokümantasyon sayfaları
  • CI/CD entegrasyonu
  • GitLab Pages

Not Alma Uygulamaları

Obsidian

  • Bilgi tabanı oluşturma
  • Bağlantılı notlar
  • Grafik görünümü
  • Eklenti ekosistemi

Joplin

  • Açık kaynak
  • End-to-end şifreleme
  • Çoklu platform desteği
  • WebClipper eklentisi

Notable

  • Minimal arayüz
  • Etiketleme sistemi
  • Özelleştirilebilir temalar
  • Dosya tabanlı depolama

Markdown Linting

markdownlint

Stil ve sözdizimi kontrolü:

# Globally kurulum
npm install -g markdownlint-cli

# Dosya kontrolü
markdownlint dosya.md

Prettier

Kod formatlama:

# Globally kurulum
npm install -g prettier

# Markdown formatla
prettier --write "**/*.md"

Özelleştirilmiş Çözümler

CSS ile Stil Özelleştirme

.markdown-body {
  font-family: "Arial", sans-serif;
  line-height: 1.6;
  color: #333;
}

.markdown-body h1 {
  border-bottom: 2px solid #eaecef;
  padding-bottom: 0.3em;
}

Özel Eklentiler Geliştirme

  • Marked.js ile özel renderer
  • Remark/Rehype plugin’leri
  • Custom preprocessor’lar

En İyi Uygulamalar

  1. Editör Seçimi

    • İhtiyaçlarınıza uygun
    • Performanslı
    • Aktif geliştirilen

  2. Versiyon Kontrolü

    • Git kullanımı
    • Düzenli commit’ler
    • Anlamlı commit mesajları

  3. Dokümantasyon

    • Tutarlı stil
    • Düzenli yapı
    • Güncel içerik

Sonuç

Bu yazı serisi boyunca Markdown’ın:

inceledik. Markdown’ın gücü, basitliği ve esnekliğinde yatıyor. Doğru araçlarla birleştiğinde, metin formatlamanın en etkili yollarından biri haline geliyor.

İpucu: Bu yazı serisindeki tüm örnekleri ve daha fazlasını GitHub’daki örnek repoda bulabilirsiniz.