Markdown Nedir? Hafif İşaretleme Dilinin Tam Açıklaması
Hızlı Yanıt
Markdown, basit semboller kullanan plain text markup dilidir: # heading, ** bold, * italic, - list, [text](url) link için. Plain text olarak okunabilir ve HTML'e dönüştürülebilir olacak şekilde tasarlanmıştır. Ücretsiz Markdown to HTML Converter kullanın.
giriiş
Markdown, John Gruber tarafından 2004'te oluşturulan, plain text formatlama kullanarak yapılandırılmış belgeler üreten hafif bir markup dilidir. Amaç okunabilirliktir —Markdown kaynak metni, HTML tag'lerinin görsel dağınıklığı olmadan temsil ettiği şey gibi görünmelidir. Markdown, GitHub'da README dosyaları, dokumentasyon siteleri, blog postaları ve Obsidian ve Notion gibi note uygulamaları için standarttır.
Adım adım
-
Temel sözdizimini öğrenin
Başlıklar: # H1, ## H2, ### H3. Kalın: **metin**. İtalik: *metin*. Listeler: - öğe veya 1. öğe. Bağlantılar: [metin](url). Görseller: . Kod: "satır içi" veya "blok". Blok alıntılar: > alıntı. Yatay kural: ---.
-
Felsefeyi anlayın
Markdown düz metin olarak okunabilecek şekilde tasarlanmıştır. Kaynak, oluşturulan son çıktıya yakın görünmelidir — **kalın** kalın gibi görünür, # Başlık bir başlığa benzer. Bu, <strong>kalın</strong> ve <h1>Başlığın</h1> görsel olarak karmaşık olduğu HTML ile tezat oluşturuyor.
-
Çeşitleri öğrenin
Orijinal Markdown (Gruber'ın spesifikasyonu) minimum düzeydedir. CommonMark standartlaştırılmış, iyi tanımlanmış bir versiyondur. GitHub Flavored Markdown (GFM), tablolar, üstü çizili, görev listeleri ve otomatik bağlantılar ekler. MDX, React bileşenlerini Markdown'a yerleştirmenize olanak tanır. Çoğu araç GFM'yi destekler.
-
Markdown'u HTML'ye dönüştür
Markdown, web yayıncılığı için HTML'ya dönüştürülür. # Merhaba, <h1>Merhaba</h1> olur, **kalın** ise <strong>kalın</strong> olur. Statik site oluşturucuları (Astro, Hugo, Jekyll) oluşturma sırasında Markdown'ı dönüştürür. Anında dönüşüm için Markdown to HTML Dönüştürücümüzü kullanın.
Örnekler
Başlık ve paragraf
Giriş: # Başlık
Bir paragraf.
Çıkış: <h1>Title</h1>
<p>A paragraph.</p>
Kalın ve italik
Giriş: **kalın** ve *italik*
Çıkış: <strong>bold</strong> and <em>italic</em>
Bağlantı ve resim
Giriş: [text](https://example.com) and 
Çıkış: <a href="https://example.com">text</a> and <img src="image.png" alt="alt">
Yaygın Sorunlar
- Satır sonları —Markdown'daki tek bir yeni satır, HTML'da satır sonu oluşturmaz. Satır sonunda iki boşluk veya paragraf sonu için iki yeni satır kullanın.
- İç içe geçmiş listeler — girinti önemlidir. İç içe geçmiş öğeler için tutarlı bir şekilde 2 veya 4 boşluk kullanın; bunları karıştırmak liste yapısını bozabilir.
- Ham HTML — Markdown ayrıştırıcılarının çoğu ham HTML'dan geçer, ancak bazıları onu sterilize eder. HTML öğesini doğrudan yerleştirirseniz ayrıştırıcınızın davranışını kontrol edin.
- Farklı tatlar — Orijinal Markdown, CommonMark ve GFM'nin ince farklılıkları vardır. Hedef platformunuzun hangi tadı desteklediğini kontrol edin.
İpuçları
- Yazmak ve belgelemek için Markdown'ı kullanın; okunması ve yazılması HTML'dan çok daha kolaydır.
- GitHub Flavored Markdown (GFM) en yaygın türdür; tablolar, üstü çizili ve görev listeleri ekler.
- Markdown'a yazın ve bloglar ve dokümantasyon siteleri için oluşturma sırasında HTML'ya dönüştürün.
- Markdown'ı tarayıcınızda anında oluşturmak için Markdown to HTML Dönüştürücümüzü kullanın.