Subliniere Markdown: ce funcționează pe GitHub și în alte motoare de redare

Markdown nu are sintaxă nativă pentru sublinierea textului. În CommonMark și GitHub Flavored Markdown, _text_ înseamnă cursiv, iar __text__ înseamnă aldin. Sublinierea necesită de obicei suport HTML sau o extensie specifică aplicației.

Pe GitHub, forma documentată este:

<ins>Termenul revizuit</ins> este vineri.

GitHub listează <ins>...</ins> pentru text subliniat în documentația de formatare de bază. Este o opțiune HTML acceptată de platformă, nu un nou delimitator Markdown care funcționează peste tot.

Comparație între subliniere, aldin și cursiv

Sursă	Semnificație	Unde este de așteptat să funcționeze
_important_	Evidențiere, de obicei cursiv	CommonMark și GFM
__important__	Evidențiere puternică, de obicei aldin	CommonMark și GFM
**important**	Evidențiere puternică, de obicei aldin	CommonMark și GFM
<ins>text adăugat</ins>	Text inserat, de obicei subliniat	Motoare cu HTML activat; documentat de GitHub
<u>text adnotat</u>	Adnotare HTML, de obicei subliniată	Motoare care permit acest element HTML

Alege aldin sau cursiv când scopul este evidențierea. De exemplu, **Scadență vineri** rămâne util într-un README, într-o notă și într-un export Markdown fără a depinde de HTML brut.

Care este diferența dintre ins și u?

Cele două etichete pot arăta similar, dar au semnificații diferite.

<ins> reprezintă text inserat într-un document. Se potrivește unei revizuiri, cum ar fi o cerință adăugată recent. Browserul îl subliniază de obicei, dar o foaie de stiluri îi poate schimba aspectul. Vezi referința MDN pentru text inserat.

Versiunea acceptă <ins>importuri CSV și TSV</ins>.

<u> marchează o adnotare care nu este evidențiere obișnuită, cum ar fi semnalarea unei greșeli de ortografie. HTML modern nu îl definește ca etichetă generală „fă acest lucru important”. Vezi referința MDN pentru elementul u.

Verifică ortografia cuvântului <u>defapt</u>.

Dacă controlezi un site și ai nevoie de subliniere strict vizuală, aplică text-decoration: underline prin CSS. O platformă Markdown găzduită poate elimina atributele de stil sau interzice stilurile personalizate, așa că nici această abordare nu este portabilă.

De ce funcționează sublinierea într-un editor, dar dispare în altul?

Sunt trei decizii separate: parserul Markdown recunoaște HTML, aplicația alege etichetele permise, iar foaia de stiluri a destinației decide aspectul elementelor permise. Suportul GFM nu garantează că un produs permite toate etichetele HTML.

Editorul MD File Viewer elimină în prezent etichetele HTML brute din intrarea utilizatorului. Lipirea lui <ins>text adăugat</ins> sau <u>text adnotat</u> lasă cuvintele fără aceste etichete, astfel încât previzualizarea nu le va sublinia. Folosește previzualizarea pentru formatarea Markdown acceptată și verifică formatarea bazată pe HTML la destinația unde va fi publicată.

Dacă muți un document HTML în Markdown, convertorul HTML în Markdown ajută la recuperarea textului, titlurilor, linkurilor și listelor. Sublinierea și CSS-ul personalizat se pot pierde deoarece Markdown simplu nu are sintaxă echivalentă. Verifică rezultatul înainte de a înlocui documentul original.

Exemple pentru README pe GitHub

Pentru o scurtă adăugare într-o notă de modificare, opțiunea HTML documentată de GitHub este:

Această versiune adaugă <ins>un pas opțional de import</ins>.

Pentru un termen sau o cerință, folosește evidențiere Markdown:

**Obligatoriu:** Include un rând de antet în fișierul CSV.

Pentru o destinație, folosește un link:

[Citește instrucțiunile de import](https://example.com/import)

Textul subliniat poate părea un link pe care se poate face clic. Evită să faci etichetele obișnuite să pară interactive, mai ales când același paragraf conține linkuri reale. Ghidul linkurilor Markdown acoperă textul descriptiv al linkurilor și linkurile de referință.

Greșeli frecvente legate de subliniere

Două caractere de subliniere fac textul aldin. Schimbarea lui **cuvânt** în __cuvânt__ schimbă delimitatorul, nu semnificația. Ambele reprezintă evidențiere puternică.

Accentele grave afișează eticheta ca pe cod. Scrierea lui `<ins>text</ins>` este utilă într-un tutorial, dar arată intenționat marcajul în loc să îl redea.

Comenzile rapide de la tastatură aparțin aplicației. Un editor de text formatat poate oferi o comandă de subliniere și poate stoca HTML sau propriul format de document. Asta nu face sublinierea parte din Markdown portabil.

Un titlu subliniat este un concept diferit. În această sursă, cratimele formează un titlu de nivel doi:

Note de lansare
-------------

Nu subliniază o expresie dintr-un paragraf. Pentru un separator între secțiuni, folosește o linie orizontală Markdown cu linii goale în jur.

Întrebări frecvente

Cum subliniez în Markdown pe GitHub?

Folosește <ins>text</ins>, pe care GitHub îl documentează pentru subliniere. Pentru evidențiere care funcționează și în motoare fără suport HTML, folosește **text** sau *text*.

Există o alternativă de subliniere doar cu Markdown?

Nu există un delimitator standard de subliniere. Unele aplicații adaugă sintaxa proprie, dar trebuie să verifici documentația și formatul folosit la export.

Se păstrează sublinierea la conversia Markdown în PDF sau Word?

Numai dacă convertorul păstrează HTML-ul sau extensia relevantă și îi acceptă stilul. Nu presupune că o subliniere vizibilă în previzualizarea unei aplicații se va păstra prin alt exportator. Inspectează fișierul rezultat sau folosește evidențiere aldină standard când portabilitatea contează.

Fișa de referință Markdown oferă o referință compactă pentru formatarea care are sintaxă Markdown dedicată.