Garis Horizontal Markdown: Pemisah, Aturan, dan Perbaikan Umum

Untuk menambahkan garis horizontal dalam Markdown, tulis tiga tanda hubung pada baris tersendiri, dengan baris kosong di atas dan di bawahnya:

Akhir bagian pertama.

---

Awal bagian berikutnya.

Hasilnya adalah pemisah antara dua paragraf. Markdown menyebutnya pemisah tematik; HTML mewakilinya dengan <hr>. Tempelkan contoh ke penampil Markdown untuk memeriksa dokumen yang dirender.

Tiga cara menulis pemisah

Semua bentuk ini menghasilkan pemisah tematik:

Sumber Markdown	Hasil
---	Garis horizontal
***	Garis horizontal
___	Garis horizontal
* * *	Garis horizontal

Gunakan setidaknya tiga tanda hubung, bintang, atau garis bawah yang sama. Spasi di antara penanda diperbolehkan. Mencampur jenis penanda, menambahkan teks pada baris yang sama, atau memakai hanya dua penanda tidak menghasilkan garis. Aturan ini berasal dari spesifikasi pemisah tematik CommonMark.

Jumlah tanda hubung tidak mengendalikan lebar garis yang terlihat. Baris dengan 20 tanda hubung dan baris dengan tiga tanda menghasilkan elemen HTML yang sama; gaya tujuan menentukan tampilannya.

Mengapa garis horizontal saya berubah menjadi judul?

Sumber ini tidak menempatkan pemisah di bawah “Catatan rilis”:

Catatan rilis
---

Sumber tersebut membuat judul tingkat dua. Tanda hubung tepat di bawah teks paragraf dapat membentuk judul Setext, dan penafsiran itu didahulukan daripada garis horizontal. Tambahkan baris kosong untuk memisahkannya:

Catatan rilis

---

Untuk bagian dokumen, judul yang eksplisit sering lebih jelas:

## Catatan rilis

Alur impor sekarang menerima berkas CSV.

Gunakan judul Markdown untuk menamai bagian. Gunakan garis horizontal ketika peralihan itu sendiri bermakna, misalnya memisahkan surat dari lampiran.

Mengapa pemisah tampil sebagai teks biasa?

Periksa sumber di sekitar garis:

Gejala	Kemungkinan penyebab	Perbaikan
Pratinjau menampilkan --- dalam blok kode	Empat spasi di awal blok tersendiri atau pagar kode belum ditutup	Hapus indentasi atau tutup pagar kode
Pratinjau menampilkan --	Hanya dua tanda hubung	Gunakan tiga atau lebih
Teks muncul di samping penanda	Baris berisi teks lain	Letakkan penanda pada baris tersendiri
--- muncul di dalam kalimat	Penanda berada dalam tanda kutip balik	Hapus tanda kutip balik jika ingin pemisah
Paragraf sebelumnya menjadi judul	Tidak ada baris kosong di atas ---	Sisipkan baris kosong

Pada tingkat teratas dokumen, pemisah tematik boleh diawali hingga tiga spasi. Di dalam daftar, indentasi juga menentukan item pemilik konten, jadi periksa daftar di sekitarnya daripada menghapus setiap spasi.

Garis horizontal berbeda dari pemisah baris

Pemisah membagi bagian dokumen. Fungsinya bukan sekadar memindahkan kata berikutnya ke baris baru.

Untuk alamat, gunakan pemisah baris tegas:

Jalan Market 120\
San Francisco, California

Untuk paragraf baru, sisakan baris kosong. Untuk pemisah bagian, gunakan --- pada baris tersendiri. Panduan pemisah baris Markdown menjelaskan spasi di akhir baris, garis miring terbalik, serta perbedaan perilaku baris baru GitHub pada berkas dan komentar.

Menempatkan pemisah di dalam kutipan

Pertahankan awalan > di setiap baris, termasuk pemisah dan baris kosong:

> Usulan awal.
>
> ---
>
> Konteks tambahan dari peninjau.

Pemisah tetap berada di dalam kutipan. Menghapus > dari garis dapat mengakhiri kutipan dan memindahkan pemisah ke tingkat luar dokumen. Lihat contoh kutipan untuk beberapa paragraf dan kutipan bersarang.

Pemisah tabel bukan garis horizontal

Baris berikut merupakan bagian dari tabel:

| Format | Dapat diedit |
| --- | :---: |
| Markdown | Ya |

Tanda pipa dan titik dua opsional mendeskripsikan kolom. Keduanya tidak menyisipkan pemisah selebar halaman. Gunakan pembuat tabel Markdown untuk membuat tabel, atau konverter CSV ke Markdown jika data sudah tersedia dalam lembar kerja.

Garis horizontal dan dokumen yang diekspor

Pemisah tematik bukan perintah pemisah halaman. Pengekspor PDF atau Word menentukan akhir halaman berdasarkan aturan tata letak dan paginasi. Jangan menambahkan tanda hubung dengan harapan bagian berikutnya akan dimulai pada halaman baru.

Untuk halaman web yang CSS-nya Anda kendalikan, <hr> yang dihasilkan dapat diberi gaya dalam lembar gaya situs. Layanan Markdown yang dihosting mungkin tidak mengizinkan CSS khusus. Periksa tujuan akhir atau dokumen ekspor, terutama jika makna pemisah harus tetap jelas setelah dicetak.

Pertanyaan umum

Apakah perlu baris kosong di sekitar garis horizontal?

CommonMark tidak mewajibkannya dalam setiap konteks, tetapi penggunaannya menghindari ambiguitas umum ketika --- dianggap judul dan membuat sumber lebih mudah dibaca.

Bisakah saya menggunakan tag hr HTML?

<hr> bekerja pada perender yang mengizinkan HTML mentah. --- lebih cocok untuk dokumen Markdown. Editor MD File Viewer menghapus tag HTML masukan pengguna, sedangkan sintaks pemisah Markdown dirender seperti biasa.

Bagaimana menampilkan tiga tanda hubung tanpa membuat pemisah?

Untuk contoh sintaks, tulis kode sebaris: `---`. Untuk teks biasa pada baris tersendiri, beri karakter pelepas pada tanda hubung pertama: \---.

Untuk pola pemformatan umum lainnya, gunakan lembar referensi Markdown.