Garis Mendatar Markdown: Pemisah, Garis dan Pembetulan Lazim

Untuk menambah garis mendatar dalam Markdown, letakkan tiga tanda sempang pada baris tersendiri, dengan baris kosong di atas dan di bawah:

Akhir bahagian pertama.

---

Permulaan bahagian seterusnya.

Hasilnya ialah pemisah antara dua perenggan. Markdown menamakannya pemisah tema; HTML mewakilinya dengan <hr>. Tampalkan contoh ke dalam pemapar Markdown untuk menyemak dokumen yang dirender.

Tiga cara menulis pemisah

Semua bentuk ini menghasilkan pemisah tema:

Sumber Markdown	Hasil
---	Garis mendatar
***	Garis mendatar
___	Garis mendatar
* * *	Garis mendatar

Gunakan sekurang-kurangnya tiga tanda sempang, asterisk atau garis bawah yang sama. Ruang antara penanda dibenarkan. Mencampurkan jenis penanda, menambah teks pada baris yang sama atau menggunakan hanya dua penanda tidak menghasilkan garis. Ini ialah peraturan sintaks daripada spesifikasi pemisah tema CommonMark.

Bilangan tanda sempang tidak mengawal lebar visual garis. Baris dengan 20 tanda sempang dan baris dengan tiga tanda sempang menghasilkan elemen HTML yang sama; gaya destinasi menentukan rupanya.

Mengapa garis mendatar saya menjadi tajuk?

Sumber ini tidak meletakkan pemisah di bawah “Nota keluaran”:

Nota keluaran
---

Ia menghasilkan tajuk tahap dua. Tanda sempang tepat di bawah teks perenggan boleh membentuk tajuk Setext, dan tafsiran itu diutamakan berbanding garis mendatar. Tambahkan baris kosong untuk memisahkan kedua-duanya:

Nota keluaran

---

Untuk bahagian dokumen, tajuk yang dinyatakan secara jelas selalunya lebih mudah difahami:

## Nota keluaran

Aliran kerja import kini menerima fail CSV.

Gunakan tajuk Markdown untuk melabel bahagian. Gunakan garis mendatar apabila peralihan itu sendiri penting, seperti memisahkan surat daripada lampiran.

Mengapa pemisah dipaparkan sebagai teks biasa?

Semak sumber di sekitar garis:

Gejala	Kemungkinan punca	Pembetulan
Pratonton menunjukkan --- dalam blok kod	Empat ruang pada permulaan blok tersendiri atau pagar kod yang belum ditutup	Buang inden atau tutup pagar kod
Pratonton menunjukkan --	Hanya dua tanda sempang	Gunakan tiga atau lebih
Teks muncul di sebelah penanda	Baris mengandungi teks lain	Letakkan penanda pada baris tersendiri
Garis dipaparkan sebagai --- dalam ayat	Penanda berada dalam tanda aksen grave	Buang tanda aksen grave jika anda mahu pemisah
Perenggan sebelumnya menjadi tajuk	Tiada baris kosong di atas ---	Masukkan baris kosong

Pada tahap teratas dokumen, sehingga tiga ruang di hadapan dibenarkan untuk pemisah tema. Dalam senarai, inden juga menentukan item yang memiliki kandungan, jadi semak senarai di sekelilingnya dan bukannya membuang setiap ruang.

Garis mendatar berbeza daripada pemisah baris

Pemisah mengasingkan bahagian. Ia bukan sekadar memindahkan perkataan berikutnya ke baris baharu.

Untuk alamat, gunakan pemisah baris paksa:

120 Jalan Market\
San Francisco, California

Untuk perenggan baharu, biarkan satu baris kosong. Untuk pemisah bahagian, gunakan --- pada baris berasingan. Panduan pemisah baris Markdown menerangkan ruang di hujung baris, garis miring terbalik serta tingkah laku baris baharu GitHub yang berbeza antara fail dan komen.

Letakkan pemisah dalam petikan blok

Kekalkan awalan > pada setiap baris, termasuk pemisah dan baris kosong:

> Cadangan asal.
>
> ---
>
> Konteks tambahan daripada penyemak.

Pemisah kekal dalam petikan. Membuang > daripada garis boleh menamatkan petikan dan memindahkan pemisah ke tahap luar dokumen. Lihat contoh petikan blok untuk berbilang perenggan dan petikan bersarang.

Pemisah jadual bukan garis mendatar

Baris ini sebahagian daripada jadual:

| Format | Boleh disunting |
| --- | :---: |
| Markdown | Ya |

Garis menegak dan tanda titik bertindih pilihan menerangkan lajur. Ia tidak memasukkan pemisah selebar halaman. Gunakan penjana jadual Markdown untuk mencipta jadual, atau penukar CSV ke Markdown apabila data sudah berada dalam hamparan.

Garis mendatar dan dokumen yang dieksport

Pemisah tema bukan arahan pemisah halaman. Pengeksport PDF atau Word menentukan penghujung halaman berdasarkan susun atur dan peraturan penomboran halamannya. Jangan tambah tanda sempang dengan harapan bahagian berikutnya akan bermula pada halaman baharu.

Untuk halaman web yang CSS-nya anda kawal, <hr> yang dijana boleh digayakan dalam helaian gaya laman. Perkhidmatan Markdown yang dihoskan mungkin tidak membenarkan CSS tersuai. Semak destinasi akhir atau dokumen yang dieksport, khususnya jika pemisah membawa makna yang mesti dikekalkan dalam cetakan.

Soalan lazim

Adakah baris kosong diperlukan di sekitar garis mendatar?

CommonMark tidak memerlukannya dalam setiap konteks, tetapi penggunaannya mengelakkan kekaburan tajuk --- yang lazim dan menjadikan fail sumber lebih mudah dibaca.

Bolehkah saya menggunakan tag HTML hr?

<hr> berfungsi dalam perender yang membenarkan HTML mentah. --- Markdown lebih sesuai untuk dokumen Markdown. Penyunting MD File Viewer membuang tag HTML yang dibekalkan pengguna, manakala sintaks pemisah Markdown dirender seperti biasa.

Bagaimanakah saya memaparkan tiga tanda sempang tanpa mencipta pemisah?

Untuk contoh sintaks, tulis kod sebaris: `---`. Untuk teks biasa pada baris tersendiri, lepaskan tanda sempang pertama: \---.

Untuk pola pemformatan lazim yang lain, simpan rujukan ringkas Markdown berdekatan.