Garis Bawah Markdown: Yang Berfungsi di GitHub dan Perender Lain

Markdown tidak mempunyai sintaks asli untuk menggariskan teks di bawah. Dalam CommonMark dan GitHub Flavored Markdown, _teks_ bermaksud italik dan __teks__ bermaksud tebal. Garis bawah biasanya memerlukan sokongan HTML atau sambungan khusus aplikasi.

Di GitHub, bentuk yang didokumenkan ialah:

<ins>Tarikh akhir yang disemak</ins> ialah hari Jumaat.

GitHub menyenaraikan <ins>...</ins> untuk teks bergaris bawah dalam dokumentasi pemformatan asasnya. Itu ialah pilihan HTML yang disokong platform, bukan pembatas Markdown baharu yang berfungsi di mana-mana.

Perbandingan garis bawah, tebal dan italik

Sumber	Makna	Tempat sokongan dijangka
_penting_	Penegasan, biasanya italik	CommonMark dan GFM
__penting__	Penegasan kuat, biasanya tebal	CommonMark dan GFM
**penting**	Penegasan kuat, biasanya tebal	CommonMark dan GFM
<ins>teks tambahan</ins>	Teks yang disisipkan, biasanya bergaris bawah	Perender dengan HTML; didokumenkan oleh GitHub
<u>teks beranotasi</u>	Anotasi HTML, biasanya bergaris bawah	Perender yang membenarkan elemen HTML ini

Pilih tebal atau italik apabila matlamatnya ialah penegasan. Contohnya, **Tarikh akhir: Jumaat** kekal berguna dalam README, nota dan eksport Markdown tanpa bergantung pada HTML mentah.

Apakah perbezaan antara ins dan u?

Kedua-dua tag boleh kelihatan serupa tetapi membawa makna berbeza.

<ins> mewakili teks yang disisipkan ke dalam dokumen. Ia sesuai untuk pindaan seperti keperluan yang baru ditambah. Pelayar lazimnya menggariskannya di bawah, tetapi helaian gaya boleh mengubah penampilan itu. Lihat rujukan teks sisipan MDN.

Keluaran ini menyokong <ins>import CSV dan TSV</ins>.

<u> menandakan anotasi yang bukan penegasan biasa, seperti menandakan kesalahan ejaan. HTML moden tidak mentakrifkannya sebagai tag umum untuk “jadikan ini penting”. Lihat rujukan elemen u MDN.

Sila semak ejaan <u>trima</u>.

Jika anda mengawal laman web dan memerlukan garis bawah yang semata-mata visual, gunakan text-decoration: underline melalui CSS. Platform Markdown yang dihoskan mungkin membuang atribut gaya atau melarang gaya tersuai, jadi pendekatan itu juga tidak boleh digunakan secara seragam merentas platform.

Mengapa garis bawah berfungsi dalam satu penyunting tetapi hilang dalam yang lain?

Terdapat tiga keputusan berasingan: penghurai Markdown mengenali HTML, aplikasi memilih tag yang dibenarkannya dan helaian gaya destinasi menentukan rupa elemen yang dibenarkan. Sokongan GFM tidak menjamin bahawa sesuatu produk membenarkan semua tag HTML.

Penyunting MD File Viewer kini membuang tag HTML mentah daripada input pengguna. Menampal <ins>teks tambahan</ins> atau <u>teks beranotasi</u> di situ meninggalkan perkataan tanpa tag tersebut, jadi pratonton tidak menggariskannya di bawah. Gunakan pratonton itu untuk pemformatan Markdown yang disokong, dan sahkan pemformatan berasaskan HTML di destinasi penerbitannya.

Jika anda memindahkan dokumen HTML ke Markdown, penukar HTML ke Markdown membantu mendapatkan semula teks, tajuk, pautan dan senarai. Garis bawah dan CSS tersuai mungkin hilang kerana Markdown biasa tiada sintaks yang setara. Semak hasil sebelum menggantikan dokumen asal.

Contoh README GitHub

Untuk tambahan ringkas dalam nota perubahan, pilihan HTML GitHub yang didokumenkan ialah:

Versi ini menambah <ins>langkah import pilihan</ins>.

Untuk tarikh akhir atau keperluan, gunakan penegasan Markdown:

**Wajib:** Sertakan baris pengepala dalam fail CSV.

Untuk destinasi, gunakan pautan:

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

Teks bergaris bawah boleh kelihatan seperti pautan boleh klik. Elakkan menjadikan label biasa kelihatan interaktif, khususnya apabila perenggan yang sama mengandungi pautan sebenar. Panduan pautan Markdown merangkumi teks pautan yang deskriptif dan pautan rujukan.

Kesilapan garis bawah yang lazim

Dua garis bawah menjadikan teks tebal. Menukar **perkataan** kepada __perkataan__ mengubah pembatas, bukan makna. Kedua-duanya mewakili penegasan kuat.

Tanda aksen grave memaparkan tag sebagai kod. Menulis `<ins>teks</ins>` berguna dalam tutorial, tetapi ia sengaja menunjukkan markup dan bukannya merendernya.

Pintasan papan kekunci milik aplikasi. Penyunting teks kaya mungkin menawarkan arahan garis bawah dan menyimpan HTML atau format dokumennya sendiri. Itu tidak menjadikan garis bawah sebahagian daripada Markdown yang boleh dipindahkan merentas platform.

Tajuk bergaris bawah ialah konsep yang berbeza. Dalam sumber ini, tanda sempang menghasilkan tajuk tahap dua:

Nota keluaran
-------------

Ia tidak menggariskan frasa dalam perenggan di bawah. Untuk pemisah antara bahagian, gunakan garis mendatar Markdown dengan baris kosong di sekelilingnya.

Soalan lazim

Bagaimanakah saya menggariskan teks Markdown di bawah di GitHub?

Gunakan <ins>teks</ins>, yang didokumenkan GitHub untuk garis bawah. Untuk penegasan yang turut berfungsi dalam perender tanpa sokongan HTML, gunakan **teks** atau *teks*.

Adakah alternatif garis bawah yang menggunakan Markdown sahaja?

Tiada pembatas garis bawah standard. Sesetengah aplikasi menambah sintaks sendiri, tetapi anda mesti menyemak dokumentasinya dan format yang digunakan semasa eksport.

Adakah garis bawah kekal selepas penukaran Markdown ke PDF atau Word?

Hanya jika penukar mengekalkan HTML atau sambungan yang berkaitan dan menyokong gayanya. Jangan anggap garis bawah yang kelihatan dalam pratonton satu aplikasi akan kekal melalui pengeksport lain. Periksa fail yang terhasil, atau gunakan penegasan tebal standard apabila kebolehgunaan merentas platform penting.

Rujukan ringkas Markdown menyediakan rujukan padat untuk pemformatan yang mempunyai sintaks Markdown khusus.