Markdown Blok Alıntısı: Alıntılar, Birden Çok Paragraf ve Listeler
Markdown alıntılarını > ile yazın, blok alıntıları iç içe yerleştirin ve birden çok paragraf alıntılayın. Word'e aktarmadan önce GitHub uyarılarını taşınabilir söz diziminden ayırın.
Markdown blok alıntısı, > ve ardından bir boşlukla başlar. Kaynağın kolay okunup düzenlenebilmesi için her alıntı satırının başına işareti koyun.
> Güncellenen kurulum rehberi incelemeye hazır.
Sonuç bir kod bloğu değil, alıntılanmış paragraftır. Kenarlığı, girintisi ve rengi, sayfanın veya belgenin temasına bağlıdır. Alıntının metni normal Markdown olarak kalır; bu yüzden vurgu, bağlantı, liste ve diğer belge yapılarını içerebilir.
Örnekleri denemek için Markdown görüntüleyiciyi kullanın, ardından düzenlenebilir bir inceleme kopyası gerektiğinde belgeyi Markdown'dan Word'e dönüştürücüyle dışa aktarın.
Bir Paragrafı Birkaç Kaynak Satırında Alıntılayın
Daha uzun bir alıntıda işareti tekrarlayın:
> Güncellenen kurulum rehberi incelemeye hazır.
> Lütfen sürümü onaylamadan önce ön koşulları kontrol edin.
Bu iki kaynak satırı, bu sitenin önizlemesinde tek paragraf oluşturur. Kaynaktaki yeni satır, görüntüde mutlaka satır sonu oluşturmaz. İfadenin iki satırda kalması gerektiğinde açık bir satır sonu ekleyin:
> Dokümantasyon incelemesi\
> Sürüm sorumlusuna atandı
Ters eğik çizgi yeni satırdan önce gelir; sonraki satır yine alıntı işaretiyle başlar. Zorunlu satır sonları ile paragraf sonları arasındaki fark için Markdown satır sonlarına bakın.
Tek Alıntıya Birden Çok Paragraf Ekleyin
Paragraflar arasındaki, başka içeriği olmayan satıra bir alıntı işareti koyun:
> İlk taslak kurulum sürecini açıklar.
>
> İkinci taslak sorun giderme adımlarını ve örnekleri ekler.
Bu, iki paragraf içeren tek bir blok alıntısı oluşturur. Ayırıcı satırda > işaretini korumak, özellikle birisi bölümü daha sonra düzenlediğinde amaçlanan gruplamayı görünür kılar.
Kendi metninize dönmek için boş bir satır bırakın ve işaret olmadan devam edin:
> İncelemede daha kısa bir kurulum bölümü istendi.
Ayrıntılı yapılandırma notlarını bir eke taşıdık.
Boş bir satır eklemeden devam satırındaki > işaretini kaldırmaktan kaçının. Bazı Markdown ayrıştırıcıları bunu alıntılanan paragrafın örtük devamı sayar. CommonMark blok alıntısı belirtimi bu davranışı açıklar. Açık işaretler ve belirgin bir boş satır, birlikte çalışanların içeriği korumasını kolaylaştırır.
Vurgu, Bağlantı ve Kaynak Bilgisi Ekleyin
Blok alıntısı içeriğinde normal satır içi biçimlendirme kullanılabilir:
> **İnceleme notu:** Geçiş adımlarına çalışan bir örnek gerekiyor.
> [Sürüm kontrol listesine](https://example.com/checklist) bakın.
>
> Dokümantasyon incelemesinden geri bildirim, Eylül 2026.
Markdown, son satıra özel bir kaynak gösterme rolü atamaz. Bu satır, alıntı içindeki normal paragraf içeriğidir. Gerektiğinde kaynağı, yazarı ve bağlantıyı ekleyin; başka birinin metnini yeniden kullanmadan önce izinleri doğrulayın.
Blok alıntısı ayrıca gerçek tırnak işaretleri eklemez. Son belge bunları gerektiriyorsa işaretleri kendiniz yazın. Kendi cümlenize yerleştirilen kısa bir alıntıda, ayrı bir blok oluşturmadan normal tırnak işaretleri yeterli olabilir.
İç İçe Alıntı veya Liste Ekleyin
Dış alıntının içinde alıntılanan içerik için ek bir > düzeyi kullanın:
> İnceleyen kişi önceki isteği özetledi:
>
> > Yapılandırma dosyasının eksiksiz bir örneğini ekleyin.
>
> Güncellenen taslak artık bu örneği içeriyor.
Raporda iç içe yerleştirme derinliğini düşük tutun. Çok derin alıntılar metnin kullanabileceği genişliği azaltır; bu da PDF ve Word düzenlerinin okunmasını zorlaştırabilir.
Alıntı içindeki liste, her satırda işareti korur:
> İncelemede iki değişiklik belirlendi:
>
> - Gerekli izinleri açıklayın.
> - Sorun giderme bölümü ekleyin.
Ters yapı olan liste içindeki alıntı için alıntıyı liste öğesinin metni altında girintileyin:
- Dokümantasyon geri bildirimi
> Yayımlamadan önce sorun giderme bölümü ekleyin.
- Sürüm kontrol listesi
Alıntı öğenin dışında görünüyorsa girintisini Markdown girinti rehberindeki örneklerle karşılaştırın.
GitHub Uyarıları Hedef Desteği Gerektirir
GitHub, alıntı söz dizimi üzerine kurulu özel uyarıları destekler. Bunlardan biri şu biçimdedir:
> [!NOTE]
> Değiştirmeden önce yapılandırmayı yedekleyin.
GitHub, desteklenen türleri uyarı başvurusunda belgeler. Uyarı renkleri ve simgeleri, her Markdown alıntısının özelliği değil, platform özellikleridir.
Bu sitenin görüntüleyicisi GitHub'ın uyarı biçimini eklemez. Örnek, görünür bir [!NOTE] etiketi taşıyan blok alıntısı olarak kalır. Farklı hedeflerde düzgün okunması gereken bir belge için açık bir kalın etiket kullanın:
> **Not:** Değiştirmeden önce yapılandırmayı yedekleyin.
Bu, özel bir uyarı uzantısı olmadan anlamın anlaşılmasını sağlar. Aynı yaklaşım uyarı, inceleme kararı veya editör notu için de kullanılabilir.
Dışa Aktarmadan Önce Alıntı Sorunlarını Giderin
> olduğu gibi görünüyorsa örneğin ters tırnaklar arasında, çitle çevrili kod bloğunda veya girintili kod bloğunda olup olmadığını kontrol edin. Bu bağlamlar kaynak metni göstermek içindir. İşaretten önceki ters eğik çizgi de işaretin özel anlamını devre dışı bırakır.
Gereğinden fazla metin alıntıya dönüşüyorsa alıntının dışında devam etmesi gereken paragrafın önüne boş satır ekleyin. İç içe içerik zor takip ediliyorsa derinliği azaltın ve kaynak bilgisini normal paragraf olarak ekleyin.
Son olarak dışa aktarılan DOCX dosyasını açıp uzun alıntıları ve alıntılanmış listeleri inceleyin. Tarayıcının sol kenarlığı ile Word belgesinin paragraf biçimi farklı olabilir. Kaynak biçimlendirme sorununu dışa aktarma stili sorunundan ayırmanız gerektiğinde ara yapıyı incelemek için Markdown'dan HTML'e aracını kullanın.