Markdown-linkgenerator

De vier linkvarianten

Inline, zonder titel:

[Lees de documentatie](https://example.com/docs)

Inline met titel (tooltip bij zweven):

[Lees de documentatie](https://example.com/docs "Volledige documentatie")

Referentiestijl (URL hieronder gedefinieerd):

Open de [documentatie][docs] of het [wijzigingslogboek][cl].

[docs]: https://example.com/docs
[cl]:   https://example.com/changelog

Autolink (de URL is zowel tekst als doel):

<https://example.com>

Wanneer kies je welke

• Inline voor incidentele links waarbij de URL kort is en de alinea nog goed leesbaar blijft.
• Referentiestijl wanneer je dezelfde URL meerdere keren aanhaalt, of wanneer de URL een trackingmonster van 200 tekens is dat anders de leesbaarheid van de alinea zou verstoren.
• Autolink voor “hier is onze documentatiepagina”, waarbij je de URL letterlijk zowel als tekst als als doel zichtbaar wilt hebben.

Omgaan met speciale tekens

• Spaties in URL’s hebben %20 nodig, anders breekt de link bij de spatie.
• Ronde haakjes in de URL moeten als %28 en %29 URL-gecodeerd worden, anders slokt de Markdown-parser ze op.
• Vierkante haakjes in de ankertekst moeten als \[ en \] worden ge-escaped, zodat de parser ze niet als geneste linksyntaxis behandelt.

Toegankelijkheidstips

• Vermijd “klik hier”. Ankertekst als klik hier of lees meer is nutteloos wanneer schermlezergebruikers met Tab door de links gaan. Gebruik beschrijvende tekst: [installatiehandleiding](...).
• Gebruik de URL zelf niet als ankertekst voor lange URL’s, dat is onvriendelijk voor hulptechnologie en oogt lelijk in druk.
• “Openen in nieuw tabblad” is ruwe HTML (target="_blank"), geen Markdown. De meeste renderers die ruwe HTML accepteren, respecteren het; puur CommonMark niet.

Sneltoets in één regel

In GitHub-reacties zet het plakken van een URL naast geselecteerde tekst deze automatisch om in een Markdown-link. Handig wanneer je al in de editor zit.