Horizontali linija Markdown: skirtukai, taisyklės ir dažni taisymai

Norėdami pridėti horizontalią liniją Markdown formatu, atskiroje eilutėje įrašykite tris brūkšnelius, palikdami tuščią eilutę viršuje ir apačioje:

Pirmo skyriaus pabaiga.

---

Kito skyriaus pradžia.

Rezultatas yra skirtukas tarp dviejų pastraipų. Markdown jį vadina teminiu skirtuku; HTML jį atvaizduoja su <hr>. Įklijuokite pavyzdį į Markdown peržiūros priemonę, kad patikrintumėte atvaizduotą dokumentą.

Trys skirtuko užrašymo būdai

Visos šios formos sukuria teminį skirtuką:

Markdown šaltinis	Rezultatas
---	Horizontali linija
***	Horizontali linija
___	Horizontali linija
* * *	Horizontali linija

Naudokite bent tris vienodus brūkšnelius, žvaigždutes arba pabraukimo ženklus. Tarp žymeklių leidžiami tarpai. Sumaišius žymeklių tipus, toje pačioje eilutėje pridėjus tekstą arba panaudojus tik du žymeklius, linija nesukuriama. Tai sintaksės taisyklės iš CommonMark teminių skirtukų specifikacijos.

Brūkšnelių skaičius nekontroliuoja matomo linijos pločio. Eilutė su 20 brūkšnelių ir eilutė su trimis sukuria tą patį HTML elementą; išvaizdą lemia paskirties vietos stiliai.

Kodėl horizontali linija virto antrašte?

Šis šaltinis neįterpia skirtuko po tekstu „Laidos pastabos“:

Laidos pastabos
---

Jis sukuria antro lygio antraštę. Brūkšneliai tiesiai po pastraipos tekstu gali sudaryti Setext antraštę, ir ši interpretacija turi pirmenybę prieš horizontalią liniją. Pridėkite tuščią eilutę, kad juos atskirtumėte:

Laidos pastabos

---

Dokumento skyriui aiškiai užrašyta antraštė dažnai yra suprantamesnė:

## Laidos pastabos

Importavimo eiga dabar priima CSV failus.

Skyriams pavadinti naudokite Markdown antraštes. Horizontalią liniją naudokite, kai svarbus pats perėjimas, pavyzdžiui, atskiriant laišką nuo priedo.

Kodėl skirtukas rodomas kaip paprastas tekstas?

Patikrinkite šaltinį aplink liniją:

Požymis	Tikėtina priežastis	Sprendimas
Peržiūroje --- rodomas kodo bloke	Keturi tarpai atskiro bloko pradžioje arba neuždaryta kodo tvorelė	Pašalinkite įtrauką arba uždarykite kodo tvorelę
Peržiūroje rodoma --	Tik du brūkšneliai	Naudokite tris ar daugiau
Šalia žymeklių yra tekstas	Eilutėje yra kito teksto	Įrašykite žymeklius atskiroje eilutėje
Linija sakinyje rodoma kaip ---	Žymekliai įrašyti tarp atgalinių apostrofų	Jei reikia skirtuko, pašalinkite atgalinius apostrofus
Ankstesnė pastraipa tampa antrašte	Virš --- nėra tuščios eilutės	Įterpkite tuščią eilutę

Aukščiausiame dokumento lygyje prieš teminį skirtuką leidžiami iki trijų tarpų. Sąrašuose įtrauka taip pat nustato, kuriam elementui priklauso turinys, todėl patikrinkite aplinkinį sąrašą, užuot pašalinę visus tarpus.

Horizontali linija skiriasi nuo eilutės lūžio

Skirtukas atskiria skyrius. Jis ne tiesiog perkelia tolesnius žodžius į naują eilutę.

Adresui naudokite priverstinį eilutės lūžį:

Market gatvė 120\
San Fransiskas, Kalifornija

Naujai pastraipai palikite tuščią eilutę. Skyrių skirtukui naudokite --- atskiroje eilutėje. Markdown eilučių lūžių vadove paaiškinami tarpai eilutės gale, pasvirieji brūkšniai atgal ir skirtingas GitHub naujų eilučių apdorojimas failuose bei komentaruose.

Skirtuko įterpimas į citatos bloką

Kiekvienoje eilutėje išlaikykite > priešdėlį, įskaitant skirtuką ir tuščias eilutes:

> Pradinis pasiūlymas.
>
> ---
>
> Papildomas recenzento paaiškinimas.

Skirtukas lieka citatos viduje. Pašalinus > nuo linijos, citata gali baigtis, o skirtukas persikelti į išorinį dokumento lygį. Kelių pastraipų ir įdėtinių citatų pavyzdžius rasite citatų blokų pavyzdžiuose.

Lentelės skirtukas nėra horizontali linija

Ši eilutė priklauso lentelei:

| Formatas | Redaguojamas |
| --- | :---: |
| Markdown | Taip |

Vertikalieji brūkšniai ir pasirinktiniai dvitaškiai aprašo stulpelius. Jie neįterpia viso puslapio pločio skirtuko. Lentelei sukurti naudokite Markdown lentelių generatorių, o jei duomenys jau yra skaičiuoklėje, naudokite CSV į Markdown konverterį.

Horizontalios linijos ir eksportuoti dokumentai

Teminis skirtukas nėra puslapio lūžio komanda. PDF arba Word eksportavimo priemonė nustato puslapių pabaigas pagal maketo ir puslapiavimo taisykles. Nepridėkite daugiau brūkšnelių tikėdamiesi, kad kitas skyrius prasidės naujame puslapyje.

Tinklalapyje, kurio CSS valdote, sugeneruotą <hr> galima formatuoti svetainės stilių lape. Priglobta Markdown paslauga gali neleisti pasirinktinio CSS. Patikrinkite galutinę paskirties vietą arba eksportuotą dokumentą, ypač jei skirtukas turi reikšmę, kuri turi išlikti spausdinant.

Dažnai užduodami klausimai

Ar aplink horizontalią liniją reikia tuščių eilučių?

CommonMark jų nereikalauja kiekviename kontekste, tačiau jos padeda išvengti dažnos --- antraštės dviprasmybės ir palengvina šaltinio failų skaitymą.

Ar galiu naudoti HTML hr žymą?

<hr> veikia atvaizdavimo priemonėse, leidžiančiose neapdorotą HTML. Markdown dokumentui labiau tinka Markdown --- sintaksė. MD File Viewer rengyklė pašalina naudotojo pateiktas HTML žymas, o Markdown skirtuko sintaksė atvaizduojama įprastai.

Kaip parodyti tris brūkšnelius nesukuriant skirtuko?

Sintaksės pavyzdžiui rašykite įterptąjį kodą: `---`. Paprastam tekstui atskiroje eilutėje apsaugokite pirmą brūkšnelį kaitos ženklu: \---.

Kitiems dažniems formatavimo būdams turėkite po ranka Markdown atmintinę.