Yazı Dizisi: Markdown
İçindekiler

Önceki yazımızda Markdown’ın gelişmiş özelliklerini incelemiştik. Bu yazıda, farklı Markdown çeşitlerini ve aralarındaki farkları ele alacağız.

Markdown Çeşitleri Neden Var?

Markdown’ın orijinal sürümü John Gruber tarafından tasarlandığında, bazı durumlar için yeterince açık tanımlanmamıştı. Bu belirsizlikler ve farklı ihtiyaçlar, çeşitli Markdown varyantlarının ortaya çıkmasına neden oldu.

Temel Markdown (Original)

John Gruber’in orijinal Markdown’ı şu temel özellikleri içerir:

  • Başlıklar
  • Paragraflar
  • Listeler
  • Alıntılar
  • Kod blokları
  • Bağlantılar
  • Görseller
  • Vurgu (kalın, italik)

GitHub Flavored Markdown (GFM)

GitHub’ın geliştirdiği ve en popüler Markdown çeşitlerinden biri olan GFM şu ek özellikleri sunar:

  • Tablolar
  • Görev listeleri (- [ ] ve - [x])
  • Üstü çizili metin (~~text~~)
  • Otomatik bağlantılar
  • Emoji desteği
  • Sözdizimi vurgulama
  • Mention’lar (@kullanıcı)
  • Issue referansları (#123)

CommonMark

CommonMark, Markdown’ı standartlaştırma çabasının bir ürünüdür. Özellikleri:

  • Net ve kesin bir şartname
  • Kapsamlı test paketi
  • Referans implementasyon
  • Tutarlı davranış garantisi

MultiMarkdown (MMD)

Fletcher Penney tarafından geliştirilen MultiMarkdown şu ek özellikleri içerir:

  • Dipnotlar
  • Tablolar
  • Tanım listeleri
  • Bibliyografya desteği
  • Matematik formülleri
  • Metadata
  • Otomatik içindekiler tablosu

Pandoc Markdown

Pandoc, en güçlü Markdown çeşitlerinden biridir ve akademik yazım için idealdir:

  • LaTeX matematik formülleri
  • Dipnotlar
  • Bibliyografya
  • Metadata blokları
  • Tablolar
  • Listeler
  • Tanım listeleri
  • Özel başlık kimlikleri
  • Birçok çıktı formatı desteği

Hangi Markdown Çeşidini Seçmeli?

İhtiyacınıza göre farklı Markdown çeşitlerini tercih edebilirsiniz:

Kullanım Senaryosu Önerilen Markdown Çeşidi
GitHub Projeleri GitHub Flavored Markdown
Akademik Yazım Pandoc Markdown
Blog Yazıları Basic Markdown veya GFM
Teknik Dokümantasyon CommonMark
Kitap Yazımı MultiMarkdown veya Pandoc

Markdown Çeşitleri Arasındaki Temel Farklar

Tablo Sözdizimi

GitHub Flavored Markdown:

| Başlık 1 | Başlık 2 |
| -------- | -------- |
| İçerik 1 | İçerik 2 |

MultiMarkdown:

| Başlık 1 | Başlık 2 |
| -------- | -------- |
| İçerik 1 | İçerik 2 |

Dipnot Sözdizimi

Pandoc/MultiMarkdown:

Metin[^1]

[^1]: Dipnot içeriği

Basic Markdown: Desteklemez

Matematik Formülleri

Pandoc:

$E = mc^2$

Basic Markdown: Desteklemez

Uyumluluk ve Dönüştürme

Farklı Markdown çeşitleri arasında dönüşüm yapmak için Pandoc gibi araçlar kullanabilirsiniz:

pandoc -f gfm -t commonmark dosya.md -o yeni.md

Sonraki Adımlar

Bu yazıda Markdown’ın farklı çeşitlerini ve kullanım senaryolarını öğrendik. Bir sonraki yazımızda Markdown için kullanabileceğiniz editörler ve araçları inceleyeceğiz.


İpucu: Bir projeye başlamadan önce, kullanacağınız platformun hangi Markdown çeşidini desteklediğini kontrol etmeyi unutmayın.