Markdown-länkgenerator

De fyra länkvarianterna

Inline, ingen titel:

[Read the docs](https://example.com/docs)

Inline med titel (hover-tooltip):

[Read the docs](https://example.com/docs "Full documentation")

Referensstil (URL definierad nedanför):

Open the [docs][docs] or the [changelog][cl].

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

Autolänk (URL:en är både text och mål):

<https://example.com>

När du ska välja vilken

• Inline för enstaka länkar där URL:en är kort och stycket fortfarande läses bra.
• Referensstil när du citerar samma URL flera gånger, eller när URL:en är ett spårningsmonster på 200 tecken som annars skulle bryta styckesflödet.
• Autolänk för “här är vår dokumentationssida” där du bokstavligen vill att URL:en ska synas som både text och mål.

Hygien för specialtecken

• Mellanslag i URL:er behöver %20 annars bryts länken vid mellanslaget.
• Parenteser i URL:en behöver URL-kodas som %28 och %29, annars äter Markdown-tolkaren dem.
• Hakparenteser i ankartext måste escapas som \[ och \] för att undvika att tolkaren behandlar dem som nästlad länksyntax.

Tillgänglighetstips

• Undvik “klicka här”. Ankartext som click here eller read more är värdelös när skärmläsaranvändare tabbar genom länkar. Använd beskrivande text: [installation guide](...).
• Lägg inte URL:en själv som ankartext för långa URL:er, det är fientligt mot hjälpmedel och fult i tryck.
• Öppna i ny flik är rå HTML (target="_blank"), inte Markdown. De flesta renderare som accepterar rå HTML respekterar det; ren CommonMark gör det inte.

Enradssgenväg

I GitHub-kommentarer konverterar inklistring av en URL bredvid markerad text den till en Markdown-länk automatiskt. Praktiskt när du redan är i redigeraren.