Onderstrepen in Markdown: wat werkt op GitHub en in andere renderers

Markdown heeft geen ingebouwde syntaxis om tekst te onderstrepen. In CommonMark en GitHub Flavored Markdown betekent _tekst_ cursief en __tekst__ vetgedrukt. Voor onderstrepen is meestal HTML-ondersteuning of een toepassingsspecifieke uitbreiding nodig.

Op GitHub is de gedocumenteerde vorm:

De <ins>aangepaste deadline</ins> is vrijdag.

GitHub vermeldt <ins>...</ins> voor onderstreepte tekst in zijn documentatie over basisopmaak. Dit is een door het platform ondersteunde HTML-optie, geen nieuw Markdown-scheidingsteken dat overal werkt.

Onderstrepen, vet en cursief vergeleken

Bron	Betekenis	Waar je het kunt verwachten
_belangrijk_	Nadruk, meestal cursief	CommonMark en GFM
__belangrijk__	Sterke nadruk, meestal vet	CommonMark en GFM
**belangrijk**	Sterke nadruk, meestal vet	CommonMark en GFM
<ins>toegevoegde tekst</ins>	Ingevoegde tekst, meestal onderstreept	Renderers met HTML-ondersteuning; gedocumenteerd door GitHub
<u>geannoteerde tekst</u>	HTML-annotatie, meestal onderstreept	Renderers die dit HTML-element toestaan

Kies vet of cursief als je nadruk wilt geven. Zo blijft **Uiterlijk vrijdag** bruikbaar in een README, een notitie en een Markdown-export zonder afhankelijk te zijn van ruwe HTML.

Wat is het verschil tussen ins en u?

De twee tags kunnen er hetzelfde uitzien, maar dragen een verschillende betekenis.

<ins> staat voor tekst die in een document is ingevoegd. Het past bij een wijziging zoals een nieuw toegevoegde eis. De browser onderstreept de tekst meestal, maar een stylesheet kan dat uiterlijk veranderen. Zie MDN over ingevoegde tekst.

Deze versie ondersteunt <ins>CSV- en TSV-imports</ins>.

<u> markeert een annotatie die geen gewone nadruk is, bijvoorbeeld het aangeven van een spelfout. Modern HTML definieert dit niet als een algemene tag voor ‘maak dit belangrijk’. Zie MDN over het u-element.

Controleer de spelling van <u>onmiddelijk</u>.

Als je een website beheert en alleen een visuele onderstreping nodig hebt, gebruik dan text-decoration: underline via CSS. Een gehost Markdown-platform kan stijlattributen verwijderen of aangepaste stijlen verbieden. Ook deze aanpak is dus niet overal overdraagbaar.

Waarom werkt onderstrepen in de ene editor en verdwijnt het in een andere?

Er zijn drie afzonderlijke beslissingen: de Markdown-parser herkent HTML, de toepassing kiest welke tags zijn toegestaan en het stylesheet op de bestemming bepaalt hoe toegestane elementen eruitzien. Ondersteuning voor GFM garandeert niet dat een product alle HTML-tags toestaat.

De MD File Viewer-editor verwijdert momenteel ruwe HTML-tags uit gebruikersinvoer. Als je daar <ins>toegevoegde tekst</ins> of <u>geannoteerde tekst</u> plakt, blijven de woorden zonder die tags over, zodat het voorbeeld ze niet onderstreept. Gebruik dat voorbeeld voor ondersteunde Markdown-opmaak en controleer HTML-opmaak op de bestemming waar deze wordt gepubliceerd.

Als je een HTML-document naar Markdown verplaatst, helpt de HTML-naar-Markdown-converter om tekst, koppen, links en lijsten terug te krijgen. Onderstreping en aangepaste CSS kunnen verloren gaan omdat gewone Markdown geen equivalente syntaxis heeft. Controleer het resultaat voordat je het originele document vervangt.

Voorbeelden voor een GitHub-README

Voor een korte toevoeging in een wijzigingsnotitie is de door GitHub gedocumenteerde HTML-optie:

Deze versie voegt <ins>een optionele importstap</ins> toe.

Gebruik voor een deadline of eis Markdown-nadruk:

**Verplicht:** Neem een koprij op in het CSV-bestand.

Gebruik voor een bestemming een link:

[Lees de importinstructies](https://example.com/import)

Onderstreepte tekst kan op een aanklikbare link lijken. Laat gewone labels niet interactief lijken, vooral wanneer dezelfde alinea echte links bevat. De handleiding voor Markdown-links behandelt beschrijvende linktekst en referentielinks.

Veelgemaakte fouten bij onderstrepen

Dubbele onderstrepingstekens maken tekst vet. **woord** veranderen in __woord__ verandert de begrenzingstekens, niet de betekenis. Beide geven sterke nadruk aan.

Backticks tonen de tag als code. `<ins>tekst</ins>` schrijven is nuttig in een handleiding, maar toont bewust de markering in plaats van die weer te geven.

Sneltoetsen horen bij de toepassing. Een tekstverwerker kan een onderstreepcommando aanbieden en HTML of zijn eigen documentformaat opslaan. Dat maakt onderstrepen geen onderdeel van overdraagbare Markdown.

Een onderstreepte kop is een ander concept. In deze bron maken de koppeltekens een kop van niveau twee:

Versie-informatie
-------------

Ze onderstrepen geen zinsdeel binnen een alinea. Gebruik voor een scheiding tussen onderdelen een horizontale Markdown-lijn met lege regels eromheen.

Veelgestelde vragen

Hoe onderstreep ik in Markdown op GitHub?

Gebruik <ins>tekst</ins>, dat GitHub documenteert voor onderstrepen. Gebruik voor nadruk die ook werkt in renderers zonder HTML-ondersteuning **tekst** of *tekst*.

Is er een alternatief voor onderstrepen met alleen Markdown?

Er is geen standaard onderstrepingsmarkering. Sommige toepassingen voegen hun eigen syntaxis toe, maar je moet hun documentatie en het bij export gebruikte formaat controleren.

Blijft onderstreping behouden bij conversie van Markdown naar PDF of Word?

Alleen als de converter de betreffende HTML of uitbreiding behoudt en de opmaak ondersteunt. Ga er niet van uit dat een onderstreping in het voorbeeld van één toepassing bij een andere exporter behouden blijft. Bekijk het resultaatbestand of gebruik standaard vetgedrukte nadruk wanneer overdraagbaarheid belangrijk is.

Het Markdown-spiekbriefje biedt een compacte referentie voor opmaak met eigen Markdown-syntaxis.