Garis Bawah Markdown: Dukungan GitHub dan Perender Lain

Markdown tidak memiliki sintaks bawaan untuk menggarisbawahi teks. Dalam CommonMark dan GitHub Flavored Markdown, _teks_ berarti miring dan __teks__ berarti tebal. Garis bawah biasanya memerlukan dukungan HTML atau ekstensi khusus aplikasi.

Pada GitHub, bentuk yang didokumentasikan adalah:

<ins>Tenggat yang direvisi</ins> adalah hari Jumat.

GitHub mencantumkan <ins>...</ins> untuk teks bergaris bawah dalam dokumentasi pemformatan dasar. Ini adalah opsi HTML yang didukung platform, bukan pembatas Markdown baru yang bekerja di mana pun.

Perbandingan garis bawah, tebal, dan miring

Sumber	Makna	Tempat dukungan
_penting_	Penekanan, biasanya miring	CommonMark dan GFM
__penting__	Penekanan kuat, biasanya tebal	CommonMark dan GFM
**penting**	Penekanan kuat, biasanya tebal	CommonMark dan GFM
<ins>teks tambahan</ins>	Teks yang disisipkan, biasanya bergaris bawah	Perender yang mengizinkan HTML; didokumentasikan GitHub
<u>teks beranotasi</u>	Anotasi HTML, biasanya bergaris bawah	Perender yang mengizinkan elemen HTML ini

Pilih tebal atau miring jika tujuannya penekanan. Misalnya, **Tenggat Jumat** tetap berguna dalam README, catatan, dan ekspor Markdown tanpa bergantung pada HTML mentah.

Apa perbedaan ins dan u?

Kedua tag dapat terlihat serupa, tetapi maknanya berbeda.

<ins> mewakili teks yang disisipkan ke dalam dokumen. Tag ini cocok untuk revisi seperti persyaratan yang baru ditambahkan. Peramban biasanya menggarisbawahinya, tetapi lembar gaya dapat mengubah tampilannya. Lihat referensi teks sisipan MDN.

Rilis ini mendukung <ins>impor CSV dan TSV</ins>.

<u> menandai anotasi yang bukan penekanan biasa, misalnya menunjukkan kesalahan ejaan. HTML modern tidak mendefinisikannya sebagai tag umum untuk “membuat ini penting”. Lihat referensi elemen u MDN.

Periksa ejaan <u>recieve</u>.

Jika Anda mengelola situs web dan hanya membutuhkan garis bawah visual, terapkan text-decoration: underline melalui CSS. Platform Markdown yang dihosting dapat menghapus atribut gaya atau melarang gaya khusus, sehingga pendekatan ini juga tidak selalu portabel.

Mengapa garis bawah bekerja di satu editor tetapi hilang di editor lain?

Ada tiga keputusan terpisah: pengurai Markdown mengenali HTML, aplikasi memilih tag yang diizinkan, dan lembar gaya tujuan menentukan tampilan elemen yang diterima. Dukungan GFM tidak menjamin produk mengizinkan semua tag HTML.

Editor MD File Viewer saat ini menghapus tag HTML mentah dari masukan pengguna. Menempelkan <ins>teks tambahan</ins> atau <u>teks beranotasi</u> menyisakan kata tanpa tag, sehingga pratinjau tidak menggarisbawahinya. Gunakan pratinjau itu untuk pemformatan Markdown yang didukung dan periksa pemformatan berbasis HTML di tujuan penerbitannya.

Jika memindahkan dokumen HTML ke Markdown, konverter HTML ke Markdown membantu mengambil kembali teks, judul, tautan, dan daftar. Garis bawah dan CSS khusus dapat hilang karena Markdown biasa tidak memiliki sintaks yang setara. Periksa hasil sebelum mengganti dokumen asli.

Contoh GitHub README

Untuk tambahan singkat dalam catatan perubahan, opsi HTML yang didokumentasikan GitHub adalah:

Versi ini menambahkan <ins>langkah impor opsional</ins>.

Untuk tenggat atau persyaratan, gunakan penekanan Markdown:

**Wajib:** Sertakan baris tajuk dalam berkas CSV.

Untuk tujuan, gunakan tautan:

[Baca petunjuk impor](https://example.com/import)

Teks bergaris bawah dapat terlihat seperti tautan yang bisa diklik. Hindari membuat label biasa tampak interaktif, terutama jika paragraf yang sama memuat tautan sungguhan. Panduan tautan Markdown membahas teks tautan yang deskriptif dan tautan referensi.

Kesalahan umum garis bawah

Garis bawah ganda membuat teks tebal. Mengubah **kata** menjadi __kata__ hanya mengganti pembatas, bukan maknanya. Keduanya menunjukkan penekanan kuat.

Tanda kutip balik menampilkan tag sebagai kode. Menulis `<ins>teks</ins>` berguna dalam tutorial, tetapi sengaja memperlihatkan markah alih-alih merendernya.

Pintasan papan ketik adalah fitur aplikasi. Editor teks berformat dapat menyediakan perintah garis bawah dan menyimpan HTML atau format dokumennya sendiri. Hal itu tidak menjadikan garis bawah bagian dari Markdown yang portabel.

Judul bergaris bawah merupakan konsep berbeda. Pada sumber berikut, tanda hubung membuat judul tingkat dua:

Catatan rilis
-------------

Tanda tersebut tidak menggarisbawahi frasa dalam paragraf. Untuk pemisah antarbagiannya, gunakan garis horizontal Markdown dengan baris kosong di sekitarnya.

Pertanyaan umum

Bagaimana membuat garis bawah dalam Markdown di GitHub?

Gunakan <ins>teks</ins>, yang didokumentasikan GitHub untuk garis bawah. Untuk penekanan yang juga bekerja pada perender tanpa dukungan HTML, gunakan **teks** atau *teks*.

Adakah alternatif garis bawah yang hanya memakai Markdown?

Tidak ada pembatas garis bawah standar. Beberapa aplikasi menambahkan sintaksnya sendiri, tetapi Anda harus memeriksa dokumentasi dan format yang dipakai saat mengekspor.

Apakah garis bawah tetap ada setelah konversi Markdown ke PDF atau Word?

Hanya jika konverter mempertahankan HTML atau ekstensi terkait dan mendukung gayanya. Jangan menganggap garis bawah yang terlihat dalam pratinjau satu aplikasi akan bertahan pada pengekspor lain. Periksa berkas hasilnya, atau gunakan penekanan tebal standar jika portabilitas penting.

Lembar referensi Markdown menyediakan ringkasan pemformatan yang memiliki sintaks Markdown khusus.