Pembuat Tautan Markdown

Empat varian tautan

Inline, tanpa judul:

[Baca dokumentasi](https://example.com/docs)

Inline dengan judul (tooltip saat kursor diarahkan):

[Baca dokumentasi](https://example.com/docs "Dokumentasi lengkap")

Gaya referensi (URL didefinisikan di bawah):

Buka [dokumentasi][docs] atau [catatan perubahan][cl].

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

Tautan otomatis (URL sekaligus menjadi teks dan tujuan):

<https://example.com>

Kapan memilih yang mana

• Inline untuk tautan sesekali dengan URL pendek dan paragraf yang tetap enak dibaca.
• Gaya referensi ketika Anda mengutip URL yang sama beberapa kali, atau ketika URL adalah rangkaian pelacakan raksasa sepanjang 200 karakter yang jika dibiarkan akan merusak alur paragraf.
• Tautan otomatis untuk kalimat seperti “ini halaman dokumentasi kami”, saat Anda benar-benar ingin URL tampil sebagai teks sekaligus sebagai tujuan.

Penanganan karakter khusus

• Spasi di dalam URL memerlukan %20, jika tidak tautan akan putus di posisi spasi.
• Tanda kurung di dalam URL perlu di-encode URL menjadi %28 dan %29, jika tidak parser Markdown akan menelannya.
• Tanda kurung siku pada teks tautan harus di-escape menjadi \[ dan \] agar parser tidak menganggapnya sebagai sintaks tautan bersarang.

Tips aksesibilitas

• Hindari “klik di sini”. Teks tautan seperti klik di sini atau baca selengkapnya tidak berguna ketika pengguna pembaca layar menelusuri tautan dengan tombol Tab. Gunakan teks deskriptif: [panduan instalasi](...).
• Jangan gunakan URL itu sendiri sebagai teks tautan untuk URL yang panjang, hal ini tidak ramah bagi teknologi bantu dan terlihat buruk saat dicetak.
• “Buka di tab baru” adalah HTML mentah (target="_blank"), bukan Markdown. Sebagian besar penyaji yang menerima HTML mentah akan menghormatinya; CommonMark murni tidak.

Pintasan satu baris

Di komentar GitHub, menempelkan URL di samping teks yang dipilih akan otomatis mengubahnya menjadi tautan Markdown. Praktis saat Anda sudah berada di dalam editor.