Understrykning i Markdown: vad fungerar på GitHub och i andra renderare?

Markdown saknar inbyggd syntax för att stryka under text. I CommonMark och GitHub Flavored Markdown betyder _text_ kursiv stil och __text__ fetstil. Understrykning kräver vanligtvis HTML-stöd eller ett programspecifikt tillägg.

På GitHub är den dokumenterade formen:

Den <ins>ändrade tidsfristen</ins> är fredag.

GitHub listar <ins>...</ins> för understruken text i sin dokumentation om grundläggande formatering. Det är ett HTML-alternativ som plattformen stöder, inte en ny Markdown-avgränsare som fungerar överallt.

Understrykning, fetstil och kursiv jämförda

Källa	Betydelse	Var det kan förväntas
_viktigt_	Betoning, vanligtvis kursiv	CommonMark och GFM
__viktigt__	Stark betoning, vanligtvis fetstil	CommonMark och GFM
**viktigt**	Stark betoning, vanligtvis fetstil	CommonMark och GFM
<ins>tillagd text</ins>	Infogad text, vanligtvis understruken	Renderare med HTML-stöd; dokumenterat av GitHub
<u>annoterad text</u>	HTML-annotation, vanligtvis understruken	Renderare som tillåter detta HTML-element

Välj fetstil eller kursiv när syftet är betoning. Till exempel förblir **Klart på fredag** användbart i en README, en anteckning och en Markdown-export utan beroende av rå HTML.

Vad är skillnaden mellan ins och u?

De två taggarna kan se likadana ut men har olika betydelse.

<ins> representerar text som infogats i ett dokument. Det passar en revidering, till exempel ett nytillagt krav. Webbläsaren stryker vanligtvis under texten, men en formatmall kan ändra utseendet. Se MDN:s referens för infogad text.

Versionen stöder <ins>CSV- och TSV-importer</ins>.

<u> markerar en annotation som inte är vanlig betoning, till exempel för att ange ett stavfel. Modern HTML definierar det inte som en allmän tagg för att ”göra detta viktigt”. Se MDN:s referens för u-elementet.

Kontrollera stavningen av <u>intresant</u>.

Om du kontrollerar en webbplats och behöver en rent visuell understrykning använder du text-decoration: underline via CSS. En värdbaserad Markdown-plattform kan ta bort stilattribut eller förbjuda egna stilar, så det tillvägagångssättet är inte heller portabelt.

Varför fungerar understrykning i en redigerare men försvinner i en annan?

Det finns tre skilda beslut: Markdown-parsern känner igen HTML, programmet väljer vilka taggar det tillåter och destinationens formatmall avgör hur tillåtna element ser ut. Stöd för GFM garanterar inte att en produkt tillåter alla HTML-taggar.

MD File Viewer-redigeraren tar för närvarande bort råa HTML-taggar från användarens inmatning. Om du klistrar in <ins>tillagd text</ins> eller <u>annoterad text</u> blir orden kvar utan taggarna, så förhandsvisningen stryker inte under dem. Använd förhandsvisningen för Markdown-formatering som stöds och kontrollera HTML-baserad formatering på den destination där den ska publiceras.

Om du flyttar ett HTML-dokument till Markdown hjälper HTML till Markdown-konverteraren dig att återställa text, rubriker, länkar och listor. Understrykning och egen CSS kan gå förlorade eftersom vanlig Markdown saknar motsvarande syntax. Kontrollera resultatet innan du ersätter originaldokumentet.

Exempel för en GitHub-README

För ett kort tillägg i en ändringsnotis är GitHubs dokumenterade HTML-alternativ:

Den här versionen lägger till <ins>ett valfritt importsteg</ins>.

Använd Markdown-betoning för en tidsfrist eller ett krav:

**Krav:** Ta med en rubrikrad i CSV-filen.

Använd en länk för en destination:

[Läs importinstruktionerna](https://example.com/import)

Understruken text kan se ut som en klickbar länk. Undvik att få vanliga etiketter att verka interaktiva, särskilt när samma stycke innehåller riktiga länkar. Guiden till Markdown-länkar behandlar beskrivande länktext och referenslänkar.

Vanliga misstag med understrykning

Dubbla understreck gör texten fet. Att ändra **ord** till __ord__ ändrar avgränsaren, inte betydelsen. Båda representerar stark betoning.

Backtick-tecken visar taggen som kod. Att skriva `<ins>text</ins>` är användbart i en handledning, men visar avsiktligt markeringen i stället för att rendera den.

Kortkommandon hör till programmet. En redigerare för formaterad text kan erbjuda ett understrykningskommando och spara HTML eller sitt eget dokumentformat. Det gör inte understrykning till en del av portabel Markdown.

En understruken rubrik är ett annat begrepp. I den här källan skapar bindestrecken en rubrik på nivå två:

Versionsinformation
-------------

De stryker inte under en fras i ett stycke. Använd en horisontell Markdown-linje med tomma rader runt för att skilja avsnitt åt.

Vanliga frågor

Hur stryker jag under i Markdown på GitHub?

Använd <ins>text</ins>, som GitHub dokumenterar för understrykning. För betoning som också fungerar i renderare utan HTML-stöd använder du i stället **text** eller *text*.

Finns det ett understrykningsalternativ med enbart Markdown?

Det finns ingen standardavgränsare för understrykning. Vissa program lägger till egen syntax, men du måste kontrollera deras dokumentation och det format som används vid export.

Bevaras understrykning vid konvertering från Markdown till PDF eller Word?

Endast om konverteraren bevarar relevant HTML eller tillägg och stöder dess formatering. Anta inte att en understrykning som syns i ett programs förhandsvisning finns kvar hos en annan exportör. Granska resultatfilen eller använd vanlig fet betoning när portabilitet är viktigt.

Markdown-fusklappen ger en kompakt referens för formatering som har egen Markdown-syntax.