Linie orizontală Markdown: separatoare, reguli și remedieri frecvente

Pentru a adăuga o linie orizontală în Markdown, pune trei cratime pe o linie separată, cu o linie goală deasupra și dedesubt:

Sfârșitul primei secțiuni.

---

Începutul secțiunii următoare.

Rezultatul este un separator între două paragrafe. Markdown îl numește separator tematic; HTML îl reprezintă prin <hr>. Lipește exemplul în vizualizatorul Markdown pentru a verifica documentul redat.

Trei moduri de a scrie un separator

Toate aceste forme produc un separator tematic:

Sursă Markdown	Rezultat
---	Linie orizontală
***	Linie orizontală
___	Linie orizontală
* * *	Linie orizontală

Folosește cel puțin trei cratime, asteriscuri sau caractere de subliniere identice. Sunt permise spații între marcatori. Amestecarea tipurilor de marcatori, adăugarea de text pe aceeași linie sau folosirea a doar doi marcatori nu creează o linie. Aceste reguli de sintaxă provin din specificația separatoarelor tematice CommonMark.

Numărul de cratime nu controlează lățimea vizuală a liniei. O linie cu 20 de cratime și una cu trei produc același element HTML; stilul destinației îi determină aspectul.

De ce s-a transformat linia orizontală într-un titlu?

Această sursă nu plasează un separator sub „Note de lansare”:

Note de lansare
---

Creează un titlu de nivel doi. Cratimele aflate direct sub textul unui paragraf pot forma un titlu Setext, iar această interpretare are prioritate față de linia orizontală. Adaugă o linie goală pentru a le separa:

Note de lansare

---

Pentru o secțiune de document, un titlu explicit este adesea mai clar:

## Note de lansare

Fluxul de import acceptă acum fișiere CSV.

Folosește titlurile Markdown pentru a eticheta secțiunile. Folosește o linie orizontală când tranziția în sine contează, de exemplu pentru a separa o scrisoare de o anexă.

De ce apare separatorul ca text simplu?

Verifică sursa din jurul liniei:

Simptom	Cauză probabilă	Remediere
Previzualizarea arată --- într-un bloc de cod	Patru spații la începutul unui bloc separat sau un delimitator de cod neînchis	Elimină indentarea sau închide delimitatorul de cod
Previzualizarea arată --	Doar două cratime	Folosește trei sau mai multe
Apare text lângă marcatori	Linia conține alt text	Pune marcatorii pe o linie separată
Linia apare ca --- într-o propoziție	Marcatorii sunt între accente grave	Elimină accentele grave dacă dorești un separator
Paragraful anterior devine titlu	Nu există linie goală deasupra lui ---	Inserează o linie goală

La nivelul superior al documentului, sunt permise până la trei spații inițiale pentru un separator tematic. În liste, indentarea stabilește și cărui element îi aparține conținutul, așa că verifică lista din jur în loc să elimini toate spațiile.

O linie orizontală diferă de o întrerupere de linie

Un separator desparte secțiuni. Nu mută pur și simplu cuvintele următoare pe o linie nouă.

Pentru o adresă, folosește o întrerupere de linie forțată:

Strada Market 120\
San Francisco, California

Pentru un paragraf nou, lasă o linie goală. Pentru un separator de secțiuni, folosește --- pe o linie separată. Ghidul întreruperilor de linie Markdown explică spațiile finale, barele oblice inverse și comportamentul diferit al liniilor noi în fișierele și comentariile GitHub.

Pune un separator într-un citat bloc

Păstrează prefixul > pe fiecare linie, inclusiv pe separator și pe liniile goale:

> Propunerea originală.
>
> ---
>
> Context suplimentar de la recenzent.

Separatorul rămâne în interiorul citatului. Eliminarea lui > de pe linie poate încheia citatul și muta separatorul la nivelul exterior al documentului. Vezi exemplele de citate bloc pentru mai multe paragrafe și citate imbricate.

Un separator de tabel nu este o linie orizontală

Această linie aparține unui tabel:

| Format | Editabil |
| --- | :---: |
| Markdown | Da |

Barele verticale și caracterele opționale două puncte descriu coloanele. Nu inserează un separator pe toată lățimea paginii. Folosește generatorul de tabele Markdown pentru a crea un tabel sau convertorul CSV în Markdown când datele există deja într-o foaie de calcul.

Linii orizontale și documente exportate

Un separator tematic nu este o comandă de întrerupere de pagină. Un exportator PDF sau Word decide unde se termină paginile pe baza regulilor de aranjare și paginare. Nu adăuga cratime suplimentare așteptând ca următoarea secțiune să înceapă pe o pagină nouă.

Pentru o pagină web al cărei CSS îl controlezi, elementul <hr> generat poate fi stilizat în foaia de stiluri a site-ului. Un serviciu Markdown găzduit poate să nu permită CSS personalizat. Verifică destinația finală sau documentul exportat, mai ales dacă separatorul transmite un sens care trebuie păstrat la tipărire.

Întrebări frecvente

Am nevoie de linii goale în jurul unei linii orizontale?

CommonMark nu le cere în orice context, dar folosirea lor evită ambiguitatea frecventă a titlului --- și face fișierele sursă mai ușor de citit.

Pot folosi o etichetă HTML hr?

<hr> funcționează în motoarele de redare care permit HTML brut. Sintaxa Markdown --- este mai potrivită pentru un document Markdown. Editorul MD File Viewer elimină etichetele HTML furnizate de utilizator, în timp ce sintaxa de separator Markdown este redată normal.

Cum afișez trei cratime fără a crea un separator?

Pentru un exemplu de sintaxă, scrie cod în linie: `---`. Pentru text obișnuit pe o linie separată, escapează prima cratimă: \---.

Pentru alte modele uzuale de formatare, ține la îndemână fișa de referință Markdown.