Markdown Satır Sonları: Yeni Satırlar, Paragraflar ve Tablo Hücreleri

Bir Markdown paragrafının içinde yeni satır başlatmak için ilk satırın sonuna ters eğik çizgi koyun, ardından Enter'a basın. Ayrı bir paragraf başlatmak için boş bir satır bırakın. Bu yöntemler farklı belge yapıları oluşturur; README dosyasını, adresi veya raporu daha sonra Word'e aktarırken bu fark önemlidir.

Dokümantasyon ekibi\
Örnek Sokak 42\
Portland, Oregon

Adres, üç satırda gösterilen tek bir paragraf olarak kalır. Aşağıdaki örneklerle karşılaştırmak için Markdown önizlemesine yapıştırın.

İhtiyacınız Olan Satır Sonu Türünü Seçin

Satır sonu, sayfa sonu oluşturmaz. Dışa aktarılan belgede sonraki bölümün yeni bir sayfada başlaması gerekiyorsa ayrı Markdown sayfa sonu rehberine bakın.

Enter'a Basmak Neden Boşluk Gibi Görünebilir?

Şu kaynağı deneyin:

Taslak hazır.
İnceleyen kişi bugün açabilir.

Bu sitenin önizlemesinde iki cümle de aynı paragrafa aittir ve birlikte akar. Yeni satır, kaynak dosyada yararlı olmaya devam eder ancak tarayıcıyı görüntüde yeni bir satır başlatmaya zorlamaz. Tarayıcı, kullanılabilir genişliğe göre metni yine kaydırabilir.

Şimdi boş bir satır ekleyin:

Taslak hazır.

İnceleyen kişi bugün açabilir.

Önizleme iki paragraf oluşturur. İkinci cümle yeni bir düşünce başlatıyorsa bu sürümü kullanın. Birkaç boş satır eklemek, fazladan dikey aralık istemenin güvenilir bir yolu değildir; paragraf biçimi görüntüleyiciye veya belge şablonuna aittir.

Ters Eğik Çizgi veya Sonda İki Boşluk

CommonMark, yeni satırdan önceki iki boşluğu ve yeni satırdan önceki ters eğik çizgiyi paragraf içinde zorunlu satır sonu söz dizimi olarak tanımlar. CommonMark zorunlu satır sonu örnekleri her iki biçimi de belgeler.

Ters eğik çizgili sürüm, dosyayı incelerken görünür:

Hazırlayan: dokümantasyon ekibi\
İnceleyen: sürüm sorumlusu

Diğer yöntem, ekibi sözcüğünden sonra tam iki boşluk yazıp Enter'a basmaktır. Bu boşluklar birçok düzenleyicide görünmez ve satır sonu boşluklarını otomatik temizleyen ayarlar tarafından kaldırılabilir. Kaydettikten sonra satır sonu kayboluyorsa boşluk ayarlarını inceleyin veya ters eğik çizgili sürümü kullanın.

Normal metne \n karakter çiftini yazıp satır sonu beklemeyin. Bu, programlama dizelerindeki bir gösterimdir; Markdown yeni satırı değildir. Ayrıca paragrafın en sonuna ters eğik çizgi koymaktan kaçının: zorunlu satır sonundan sonra paragraf içeriğini taşıyan başka bir satır gelmelidir.

GitHub Yorumları ve README Dosyaları Farklı Davranır

GitHub'ın satır sonu belgeleri, depolardaki .md dosyalarını konulardan, çekme isteklerinden ve tartışmalardan ayırır. Bu konuşma alanlarında normal yeni satırlar, satır sonu olarak gösterilebilirken README açık bir zorunlu satır sonu söz dizimi gerektirir.

Bu fark, bir konudan kopyalanan metnin README içinde neden farklı görünebildiğini açıklar. Aynı web sitesindeki her alanın aynı biçimlendirme kurallarını kullandığını varsaymak yerine hedef dosyayı inceleyin.

Devam Satırını Liste Öğesinin İçinde Tutun

Devam satırını, öğe metninin başlangıcıyla hizalayacak şekilde girintileyin:

- Sürüm notları\
  Geçiş talimatlarını ekleyin.
- Kurulum rehberi

Burada ilk öğe görüntüde iki satır içerir. İkinci öğe ayrı kalır. İlk öğenin içinde ayrı bir paragraf oluşturmak için boş bir satır kullanın ve devam satırının girintisini koruyun:

- Sürüm notları

  Geçiş talimatlarını ve bilinen sorunları ekleyin.
- Kurulum rehberi

Girinti rehberi, numaralı listeleri, iç içe madde işaretlerini ve öğe içindeki kodu ele alır.

Markdown Tablo Hücresine Yeni Satır Ekleyin

GFM tablo satırı tek bir kaynak satırında bulunmalıdır. İçeriğinde Enter'a basmak satırı bölebilir. HTML satır sonlarına izin veren görüntüleyicilerde şu düzeni kullanın:

| Belge | Sorumlular |
| --- | --- |
| Sürüm notları | Yazar<br>İnceleyen |

Bu sitenin önizlemesi örneği destekler. HTML'yi kaldıran bir hedef, satır sonunu kaldırabilir veya etiketi gösterebilir; bu nedenle yöntemi belgenin tamamına uygulamadan önce platformu kontrol edin. Bir hücre birkaç paragraf gerektiriyorsa tablo dışındaki bir listenin bakımı genellikle daha kolaydır.

Tablo verileri için Markdown tablo oluşturucuyu, hizalama ve dikey çizgilerin kaçış karakteriyle yazılması için tablo söz dizimi rehberini kullanın.

Dışa Aktarılan Belgeyi Kontrol Edin

Markdown'dan Word'e dönüştürücüyü kullanmadan önce bir normal yeni satır, bir açık zorunlu satır sonu ve bir boş satır içeren kısa bir örnek deneyin. Önizleme sırasıyla tek bir akan paragraf, zorunlu satır sonu ve iki ayrı paragraf göstermelidir.

İndirilen DOCX dosyasını açıp adresi, listeleri ve tabloyu inceleyin. Sayfa genişliği ve Word'ün paragraf stilleri, alttaki satır sonları doğru olsa bile metnin kaydırılmasını değiştirebilir. Önce Markdown yapısını düzeltin; belirli bir belge şablonu gerektiriyorsa son tipografiyi Word'de ayarlayın.