Vízszintes vonal Markdownban: elválasztók, szabályok és gyakori javítások

Vízszintes vonal Markdownban történő hozzáadásához írjon három kötőjelet külön sorba, előtte és utána egy-egy üres sorral:

Az első szakasz vége.

---

A következő szakasz kezdete.

Az eredmény két bekezdés közötti elválasztó. A Markdown ezt tematikus elválasztásnak nevezi; a HTML-ben a <hr> képviseli. Illessze a példát a Markdown-megjelenítőbe a megjelenített dokumentum ellenőrzéséhez.

Az elválasztó háromféle írásmódja

Ezek az alakok mind tematikus elválasztást hoznak létre:

Markdown-forrás	Eredmény
---	Vízszintes vonal
***	Vízszintes vonal
___	Vízszintes vonal
* * *	Vízszintes vonal

Használjon legalább három azonos kötőjelet, csillagot vagy aláhúzásjelet. A jelek között szóközök is lehetnek. A jeltípusok keverése, ugyanabba a sorba írt szöveg vagy csupán két jel használata nem hoz létre vonalat. Ezek a szintaktikai szabályok a CommonMark tematikus elválasztási specifikációjából származnak.

A kötőjelek száma nem szabályozza a vonal látható szélességét. A 20 kötőjeles és a három kötőjeles sor ugyanazt a HTML-elemet hozza létre; a megjelenést a célhely stílusa határozza meg.

Miért lett címsor a vízszintes vonalamból?

Ez a forrás nem tesz elválasztót a „Kiadási megjegyzések” alá:

Kiadási megjegyzések
---

Második szintű címsort hoz létre. A közvetlenül a bekezdés szövege alatti kötőjelek Setext-címsort alkothatnak, és ez az értelmezés megelőzi a vízszintes vonalat. A kettő elválasztásához szúrjon be üres sort:

Kiadási megjegyzések

---

Egy dokumentumszakaszhoz az egyértelműen megadott címsor gyakran világosabb:

## Kiadási megjegyzések

Az importálási folyamat már CSV-fájlokat is fogad.

A szakaszok elnevezéséhez használjon Markdown-címsorokat. Akkor használjon vízszintes vonalat, ha maga az átmenet fontos, például egy levél és melléklete között.

Miért jelenik meg az elválasztó egyszerű szövegként?

Ellenőrizze a vonal körüli forrást:

Tünet	Valószínű ok	Javítás
Az előnézet kódblokkban mutatja a --- jeleket	Négy szóköz egy önálló blokk elején vagy lezáratlan kódkerítés	Távolítsa el a behúzást, vagy zárja le a kódkerítést
Az előnézet -- jelet mutat	Csak két kötőjel van	Használjon legalább hármat
Szöveg jelenik meg a jelek mellett	A sor más szöveget is tartalmaz	Tegye a jeleket külön sorba
A vonal --- alakban látszik egy mondatban	A jelek fordított aposztrófok között vannak	Ha elválasztót szeretne, távolítsa el a fordított aposztrófokat
Az előző bekezdés címsorrá válik	Nincs üres sor a --- felett	Szúrjon be üres sort

A dokumentum legfelső szintjén a tematikus elválasztást legfeljebb három kezdő szóköz előzheti meg. Listákon belül a behúzás azt is meghatározza, melyik elemhez tartozik a tartalom, ezért az összes szóköz törlése helyett ellenőrizze a környező listát.

A vízszintes vonal nem ugyanaz, mint a sortörés

Az elválasztó szakaszokat választ szét. Nem egyszerűen új sorba helyezi a következő szavakat.

Címhez használjon kényszerített sortörést:

Market utca 120.\
San Francisco, Kalifornia

Új bekezdéshez hagyjon üres sort. Szakaszelválasztóhoz írjon --- jelet külön sorba. A Markdown-sortörési útmutató ismerteti a sorvégi szóközöket, a fordított perjeleket, valamint a GitHub eltérő újsor-kezelését fájlokban és hozzászólásokban.

Elválasztó idézetblokkon belül

Minden sor elején tartsa meg a > előtagot, az elválasztónál és az üres soroknál is:

> Eredeti javaslat.
>
> ---
>
> További háttérinformáció a bírálótól.

Az elválasztó az idézeten belül marad. A > eltávolítása a vonal elől lezárhatja az idézetet, és az elválasztót a dokumentum külső szintjére helyezheti. Több bekezdéshez és egymásba ágyazott idézetekhez lásd az idézetblokk-példákat.

A táblázatelválasztó nem vízszintes vonal

Ez a sor egy táblázathoz tartozik:

| Formátum | Szerkeszthető |
| --- | :---: |
| Markdown | Igen |

A függőleges vonalak és a választható kettőspontok az oszlopokat írják le. Nem szúrnak be oldalszélességű elválasztót. Táblázat létrehozásához használja a Markdown-táblázatgenerátort, ha pedig az adatok már táblázatkezelőben vannak, a CSV Markdownná alakítót.

Vízszintes vonalak és exportált dokumentumok

A tematikus elválasztás nem oldaltörési parancs. A PDF- vagy Word-exportáló az elrendezési és lapozási szabályok alapján dönti el, hol ér véget az oldal. Ne adjon hozzá további kötőjeleket abban a reményben, hogy a következő szakasz új oldalon kezdődik.

Olyan weboldalon, amelynek CSS-ét Ön kezeli, a létrejött <hr> a webhely stíluslapjában formázható. Egy hosztolt Markdown-szolgáltatás nem feltétlenül engedélyez egyéni CSS-t. Ellenőrizze a végső célhelyet vagy az exportált dokumentumot, különösen, ha az elválasztó olyan jelentést hordoz, amelynek nyomtatásban is meg kell maradnia.

Gyakori kérdések

Kellenek üres sorok a vízszintes vonal köré?

A CommonMark nem minden környezetben követeli meg őket, de használatuk elkerüli a --- címsor gyakori kétértelműségét, és olvashatóbbá teszi a forrásfájlokat.

Használhatok HTML hr címkét?

A <hr> működik a nyers HTML-t engedélyező megjelenítőkben. Markdown-dokumentumhoz a Markdown --- jelölése alkalmasabb. Az MD File Viewer szerkesztője eltávolítja a felhasználó által megadott HTML-címkéket, a Markdown elválasztószintaxisa viszont rendesen megjelenik.

Hogyan jelenítsek meg három kötőjelet elválasztó létrehozása nélkül?

Szintaktikai példához írjon sorközi kódot: `---`. Külön sorban álló közönséges szöveghez escape-elje az első kötőjelet: \---.

Más gyakori formázási mintákhoz tartsa kéznél a Markdown-puskát.