Markdown Alt Çizgi: GitHub ve Diğer Görüntüleyicilerde Ne Çalışır?

Markdown'da metnin altını çizmek için yerel bir sözdizimi yoktur. CommonMark ve GitHub Flavored Markdown'da _metin_ italik, __metin__ kalın anlamına gelir. Alt çizgi genellikle HTML desteği veya uygulamaya özgü bir uzantı gerektirir.

GitHub'da belgelenen biçim şöyledir:

<ins>Güncellenen son tarih</ins> cuma günüdür.

GitHub, temel biçimlendirme belgelerinde altı çizili metin için <ins>...</ins> biçimini listeler. Bu, platformun desteklediği bir HTML seçeneğidir; her yerde çalışan yeni bir Markdown sınırlayıcısı değildir.

Altı çizili, kalın ve italik karşılaştırması

Kaynak	Anlamı	Beklenen destek
_önemli_	Vurgu, genellikle italik	CommonMark ve GFM
__önemli__	Güçlü vurgu, genellikle kalın	CommonMark ve GFM
**önemli**	Güçlü vurgu, genellikle kalın	CommonMark ve GFM
<ins>eklenen metin</ins>	Eklenmiş metin, genellikle altı çizili	HTML destekli görüntüleyiciler; GitHub tarafından belgelenir
<u>açıklama eklenen metin</u>	HTML açıklaması, genellikle altı çizili	Bu HTML öğesine izin veren görüntüleyiciler

Amaç vurguysa kalın veya italik kullanın. Örneğin **Son tarih: cuma**, ham HTML'ye bağlı olmadan README'de, notta ve Markdown dışa aktarımında kullanılabilir.

ins ile u arasındaki fark nedir?

İki etiket benzer görünebilir, ancak farklı anlamlar taşır.

<ins>, belgeye eklenen metni temsil eder. Yeni eklenen bir gereksinim gibi değişiklikler için uygundur. Tarayıcı genellikle altını çizer, ancak stil sayfası bu görünümü değiştirebilir. MDN'nin eklenmiş metin başvurusuna bakın.

Sürüm <ins>CSV ve TSV içe aktarmalarını</ins> destekler.

<u>, yazım hatasını işaretlemek gibi sıradan vurgu olmayan bir açıklamayı belirtir. Modern HTML bunu genel amaçlı “önemli yap” etiketi olarak tanımlamaz. MDN'nin u öğesi başvurusuna bakın.

Lütfen <u>yalnış</u> sözcüğünün yazımını kontrol edin.

Bir web sitesini kontrol ediyorsanız ve yalnızca görsel alt çizgi gerekiyorsa CSS ile text-decoration: underline uygulayın. Barındırılan Markdown platformu stil özniteliklerini kaldırabilir veya özel stilleri yasaklayabilir; bu nedenle bu yaklaşım da taşınabilir değildir.

Alt çizgi neden bir düzenleyicide çalışırken diğerinde kayboluyor?

Üç ayrı karar vardır: Markdown ayrıştırıcısı HTML'yi tanır, uygulama hangi etiketlere izin vereceğini seçer ve hedefin stil sayfası izin verilen öğelerin nasıl görüneceğini belirler. GFM desteği, ürünün tüm HTML etiketlerine izin verdiğini garanti etmez.

MD File Viewer düzenleyicisi şu anda kullanıcı girdisindeki ham HTML etiketlerini kaldırır. Oraya <ins>eklenen metin</ins> veya <u>açıklama eklenen metin</u> yapıştırmak sözcükleri etiketler olmadan bırakır, dolayısıyla önizlemede altları çizilmez. Bu önizlemeyi desteklenen Markdown biçimlendirmesi için kullanın ve HTML tabanlı biçimlendirmeyi yayımlanacağı hedefte doğrulayın.

Bir HTML belgesini Markdown'a taşıyorsanız HTML'den Markdown'a dönüştürücü metni, başlıkları, bağlantıları ve listeleri geri kazanmanıza yardımcı olur. Düz Markdown'da karşılıkları bulunmadığından alt çizgiler ve özel CSS kaybolabilir. Özgün belgeyi değiştirmeden önce sonucu kontrol edin.

GitHub README örnekleri

Değişiklik notundaki kısa bir ekleme için GitHub'ın belgelenmiş HTML seçeneği şöyledir:

Bu sürüm <ins>isteğe bağlı bir içe aktarma adımı</ins> ekler.

Son tarih veya gereksinim için Markdown vurgusu kullanın:

**Gerekli:** CSV dosyasına bir başlık satırı ekleyin.

Bir hedefe yönlendirmek için bağlantı kullanın:

[İçe aktarma talimatlarını okuyun](https://example.com/import)

Altı çizili metin tıklanabilir bağlantıya benzeyebilir. Özellikle aynı paragrafta gerçek bağlantılar varken normal etiketleri etkileşimliymiş gibi göstermeyin. Markdown bağlantıları kılavuzu, açıklayıcı bağlantı metnini ve referans bağlantılarını ele alır.

Yaygın alt çizgi hataları

Çift alt çizgi metni kalın yapar. **sözcük** ifadesini __sözcük__ olarak değiştirmek anlamı değil, sınırlayıcıyı değiştirir. İkisi de güçlü vurguyu temsil eder.

Ters tırnaklar etiketi kod olarak gösterir. `<ins>metin</ins>` yazmak bir eğitimde yararlıdır; ancak işaretlemeyi işlemek yerine özellikle görünür kılar.

Klavye kısayolları uygulamaya aittir. Zengin metin düzenleyicisi alt çizgi komutu sunabilir ve HTML veya kendi belge biçimini saklayabilir. Bu, alt çizgiyi taşınabilir Markdown'ın parçası yapmaz.

Altı çizili başlık farklı bir kavramdır. Bu kaynakta kısa çizgiler ikinci düzey bir başlık oluşturur:

Sürüm notları
-------------

Paragraf içindeki bir ifadenin altını çizmezler. Bölümler arasında ayırıcı için çevresinde boş satırlar olan bir Markdown yatay çizgisi kullanın.

Sık sorulan sorular

GitHub'da Markdown metninin altını nasıl çizerim?

GitHub'ın alt çizgi için belgelediği <ins>metin</ins> biçimini kullanın. HTML desteği olmayan görüntüleyicilerde de çalışan vurgu için **metin** veya *metin* kullanın.

Yalnızca Markdown kullanan bir alt çizgi alternatifi var mı?

Standart bir alt çizgi sınırlayıcısı yoktur. Bazı uygulamalar kendi sözdizimlerini ekler; ancak belgelerini ve dışa aktarımda kullanılan biçimi kontrol etmelisiniz.

Markdown'dan PDF veya Word'e dönüştürmede alt çizgi korunur mu?

Yalnızca dönüştürücü ilgili HTML'yi veya uzantıyı korur ve stilini desteklerse. Bir uygulamanın önizlemesinde görünen alt çizginin başka bir dışa aktarıcıda korunacağını varsaymayın. Oluşan dosyayı inceleyin veya taşınabilirlik önemliyse standart kalın vurgu kullanın.

Markdown kısa başvuru kılavuzu, özel Markdown sözdizimine sahip biçimlendirmeler için kısa bir başvuru sunar.