Pahalang na Linya sa Markdown: Mga Panghiwalay at Karaniwang Pag-aayos

Upang magdagdag ng pahalang na linya sa Markdown, ilagay ang tatlong gitling sa sarili nitong linya, na may bakanteng linya sa itaas at ibaba:

Wakas ng unang seksiyon.

---

Simula ng susunod na seksiyon.

Ang resulta ay panghiwalay sa pagitan ng dalawang talata. Tinatawag itong tematikong paghihiwalay sa Markdown; kinakatawan ito ng <hr> sa HTML. Idikit ang halimbawa sa tagatingin ng Markdown upang suriin ang na-render na dokumento.

Tatlong paraan ng pagsulat ng panghiwalay

Lahat ng anyong ito ay lumilikha ng tematikong paghihiwalay:

Pinagmulang Markdown	Resulta
---	Pahalang na linya
***	Pahalang na linya
___	Pahalang na linya
* * *	Pahalang na linya

Gumamit ng hindi bababa sa tatlong magkakatulad na gitling, asterisk, o underscore. Puwedeng may puwang sa pagitan ng mga pananda. Hindi lumilikha ng linya ang paghahalo ng uri ng pananda, pagdaragdag ng teksto sa parehong linya, o paggamit ng dalawang pananda lamang. Mga tuntunin ito mula sa espesipikasyon ng tematikong paghihiwalay ng CommonMark.

Hindi kinokontrol ng dami ng gitling ang nakikitang lapad ng linya. Parehong HTML element ang ginagawa ng linyang may 20 gitling at ng may tatlo; ang estilo ng destinasyon ang nagtatakda ng anyo nito.

Bakit naging pamagat ang pahalang kong linya?

Hindi naglalagay ang source na ito ng panghiwalay sa ilalim ng “Mga tala ng bersiyon”:

Mga tala ng bersiyon
---

Lumilikha ito ng pamagat na ikalawang antas. Ang mga gitling na tuwirang nasa ibaba ng teksto ng talata ay maaaring bumuo ng Setext heading, at mas inuuna ang interpretasyong iyon kaysa sa pahalang na linya. Magdagdag ng bakanteng linya upang paghiwalayin ang dalawa:

Mga tala ng bersiyon

---

Para sa seksiyon ng dokumento, madalas mas malinaw ang tahasang pamagat:

## Mga tala ng bersiyon

Tumatanggap na ngayon ng CSV file ang proseso ng pag-import.

Gamitin ang mga pamagat sa Markdown upang pangalanan ang mga seksiyon. Gumamit ng pahalang na linya kung mahalaga mismo ang paglipat, gaya ng paghihiwalay ng liham at apendise.

Bakit lumilitaw bilang payak na teksto ang panghiwalay?

Suriin ang source sa paligid ng linya:

Sintomas	Malamang na sanhi	Pag-aayos
Ipinapakita ng paunang tingin ang --- sa bloke ng code	Apat na puwang sa simula ng hiwalay na bloke, o hindi naisara ang code fence	Alisin ang indent o isara ang code fence
Ipinapakita ng paunang tingin ang --	Dalawang gitling lamang	Gumamit ng tatlo o higit pa
May teksto sa tabi ng mga pananda	May ibang teksto ang linya	Ilagay ang mga pananda sa sarili nilang linya
Lumilitaw ang linya bilang --- sa loob ng pangungusap	Nasa loob ng backtick ang mga pananda	Alisin ang backtick kung panghiwalay ang nais
Nagiging pamagat ang naunang talata	Walang bakanteng linya sa itaas ng ---	Magpasok ng bakanteng linya

Sa pinakamataas na antas ng dokumento, pinapayagan ang hanggang tatlong puwang bago ang tematikong panghiwalay. Sa mga listahan, tinutukoy rin ng indent kung saang item kabilang ang nilalaman, kaya suriin ang nakapaligid na listahan sa halip na alisin ang lahat ng puwang.

Iba ang pahalang na linya sa line break

Pinaghihiwalay ng panghiwalay ang mga seksiyon. Hindi lang nito inililipat ang susunod na mga salita sa bagong linya.

Para sa address, gumamit ng sapilitang line break:

120 Kalye Market\
San Francisco, California

Para sa bagong talata, mag-iwan ng bakanteng linya. Para sa panghiwalay ng seksiyon, gumamit ng --- sa hiwalay na linya. Ipinapaliwanag ng gabay sa mga line break sa Markdown ang mga puwang sa dulo, mga backslash, at magkaibang asal ng bagong linya sa mga file at komento sa GitHub.

Maglagay ng panghiwalay sa loob ng blockquote

Panatilihin ang > sa simula ng bawat linya, kasama ang panghiwalay at mga bakanteng linya:

> Orihinal na mungkahi.
>
> ---
>
> Karagdagang konteksto mula sa tagasuri.

Mananatili sa loob ng sipi ang panghiwalay. Maaaring tapusin ng pag-alis ng > sa linya ang sipi at ilipat ang panghiwalay sa panlabas na dokumento. Tingnan ang mga halimbawa ng blockquote para sa maraming talata at mga siping nakapaloob sa ibang sipi.

Hindi pahalang na linya ang panghiwalay sa talahanayan

Bahagi ng talahanayan ang linyang ito:

| Format | Nae-edit |
| --- | :---: |
| Markdown | Oo |

Inilalarawan ng mga patayong guhit at opsyonal na tutuldok ang mga kolum. Hindi sila naglalagay ng panghiwalay na kasinglapad ng pahina. Gamitin ang tagagawa ng talahanayang Markdown upang gumawa ng talahanayan, o ang CSV tungo sa Markdown converter kung nasa spreadsheet na ang datos.

Mga pahalang na linya at na-export na dokumento

Hindi utos ng page break ang tematikong paghihiwalay. Ang PDF o Word exporter ang nagpapasya kung saan nagtatapos ang pahina batay sa layout at mga tuntunin nito sa paghahati ng pahina. Huwag magdagdag ng mga gitling sa pag-asang magsisimula sa bagong pahina ang susunod na seksiyon.

Para sa web page na kontrolado mo ang CSS, maaaring lagyan ng estilo ang nabuong <hr> sa stylesheet ng site. Maaaring hindi payagan ng naka-host na serbisyo ng Markdown ang pasadyang CSS. Suriin ang huling destinasyon o na-export na dokumento, lalo na kung may kahulugang kailangang manatili sa pag-print ang panghiwalay.

Mga madalas itanong

Kailangan ba ng mga bakanteng linya sa paligid ng pahalang na linya?

Hindi ito hinihingi ng CommonMark sa lahat ng konteksto, ngunit ang paggamit nito ay umiiwas sa karaniwang kalituhan sa pamagat na --- at nagpapadali sa pagbasa ng source file.

Maaari ba akong gumamit ng HTML hr tag?

Gumagana ang <hr> sa mga renderer na nagpapahintulot ng raw HTML. Mas angkop ang --- ng Markdown para sa dokumentong Markdown. Inaalis ng MD File Viewer editor ang mga HTML tag na ibinigay ng gumagamit, samantalang normal na nare-render ang sintaks ng panghiwalay sa Markdown.

Paano ko ipapakita ang tatlong gitling nang hindi gumagawa ng panghiwalay?

Para sa halimbawa ng sintaks, gumamit ng inline na code: `---`. Para sa karaniwang teksto sa hiwalay na linya, lagyan ng escape ang unang gitling: \---.

Para sa iba pang karaniwang paraan ng pag-format, panatilihing madaling mahanap ang maikling sanggunian sa Markdown.