Markdown Bağlantı Oluşturucu

Dört bağlantı varyantı

Satır içi, başlıksız:

[Belgeleri oku](https://example.com/docs)

Satır içi, başlıklı (fareyle üzerine gelince ipucu):

[Belgeleri oku](https://example.com/docs "Tam belgeler")

Referans stili (URL aşağıda tanımlı):

[Belgeleri][docs] veya [değişiklik günlüğünü][cl] açın.

[docs]: https://example.com/docs
[cl]:   https://example.com/changelog

Otomatik bağlantı (URL hem metin hem de hedeftir):

<https://example.com>

Hangisini ne zaman seçmeli

• Satır içi, URL kısa olduğunda ve paragraf hâlâ rahat okunduğunda arada bir kullanılan bağlantılar için uygundur.
• Referans stili, aynı URL’yi birden çok kez alıntıladığınızda ya da URL, paragrafın akışını bozacak 200 karakterlik dev bir izleme dizisi olduğunda işe yarar.
• Otomatik bağlantı, “işte belge sayfamız” gibi, URL’nin hem metin hem de hedef olarak görünmesini gerçekten istediğiniz durumlar içindir.

Özel karakter hijyeni

• URL’lerdeki boşluklar %20 gerektirir; aksi hâlde bağlantı boşlukta kopar.
• URL’deki parantezler %28 ve %29 olarak URL kodlaması gerektirir; aksi hâlde Markdown ayrıştırıcısı onları yutar.
• Bağlantı metnindeki köşeli parantezler, ayrıştırıcının onları iç içe bağlantı söz dizimi sanmaması için \[ ve \] olarak kaçış karakteriyle yazılmalıdır.

Erişilebilirlik ipuçları

• “Buraya tıklayın” ifadesinden kaçının. Ekran okuyucu kullanıcıları bağlantılar arasında sekme tuşuyla gezerken click here veya read more gibi bağlantı metinleri işe yaramaz. Açıklayıcı bir metin kullanın: [kurulum kılavuzu](...).
• Uzun URL’lerde URL’nin kendisini bağlantı metni olarak koymayın; bu, yardımcı teknolojiler için elverişsizdir ve baskıda kötü görünür.
• “Yeni sekmede aç”, Markdown değil ham HTML’dir (target="_blank"). Ham HTML’yi kabul eden işleyicilerin çoğu buna uyar; saf CommonMark uymaz.

Tek satırlık kısayol

GitHub yorumlarında, seçili metnin yanına bir URL yapıştırmak onu otomatik olarak Markdown bağlantısına dönüştürür. Zaten düzenleyicideyken pratiktir.