Markdown Rehberi: Temel Sözdizimi

Yayınlanma Tarihi:
#markdown#yazarlık#rehber

Markdown, düz metin kullanarak biçimlendirilmiş belgeler oluşturmanıza olanak tanıyan hafif bir işaret dilidir. Zahit gibi Astro tabanlı sitelerde içerik üretmenin en doğal yolu budur.

Başlıklar

# H1 Başlık
## H2 Başlık
### H3 Başlık

Metin Biçimlendirme

Kalın metin için çift yıldız, italik için tek yıldız kullanılır. Üstü çizili metin için ise çift tilde.

Alıntı blokları için > karakterini kullanabilirsiniz. Okuyucunun dikkatini çekmek istediğiniz önemli cümleleri bu şekilde vurgulayabilirsiniz.

Listeler

Sırasız liste:

  • Birinci madde
  • İkinci madde
    • İç içe madde
  • Üçüncü madde

Sıralı liste:

  1. Önce bunu yap
  2. Sonra şunu
  3. En son bunu

Bağlantılar ve Görseller

Astro resmi sitesi formatında bağlantı ekleyebilirsiniz.

Kod Blokları

Satır içi kod için backtick kullanılır.

function zahit() {
  return 'Sadelik, eksiklik değil derinliktir.';
}

Tablolar

Sözdizimi Açıklama
**kalın** Kalın metin
*italik* İtalik metin
[metin](url) Bağlantı

Grafikler (MDX)

.mdx uzantılı yazılarınızda herhangi bir ek import işlemine gerek kalmadan doğrudan <Chart /> bileşenini kullanabilirsiniz. Grafik kütüphanesi yalnızca bileşenin bulunduğu sayfalarda ve okuyucu grafiğe yaklaştığında (lazy-load) yüklenir:

<Chart
  type="bar"
  data={{
    labels: ['Chrome', 'Safari', 'Edge', 'Firefox'],
    datasets: [{
      label: 'Tarayıcı Kullanım Oranı (%)',
      data: [68.5, 16.3, 5.0, 2.4],
      backgroundColor: ['#4fa5d8', 'rgba(79, 165, 216, 0.35)', 'rgba(79, 165, 216, 0.35)', '#f97316']
    }]
  }}
  options={{
    scales: {
      y: { beginAtZero: true, ticks: { suffix: '%' } },
      x: { grid: { display: false } }
    }
  }}
/>

Markdown öğrenmek birkaç dakika alır; ustalaşmak ise sizi özgür kılar.