Markdown-Link-Generator

Die vier Linkvarianten

Inline, ohne Titel:

[Dokumentation lesen](https://example.com/docs)

Inline mit Titel (Hover-Tooltip):

[Dokumentation lesen](https://example.com/docs "Vollständige Dokumentation")

Referenzstil (URL unten definiert):

Öffnen Sie die [Dokumentation][docs] oder das [Änderungsprotokoll][cl].

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

Autolink (URL ist sowohl Text als auch Ziel):

<https://example.com>

Wann welchen Stil wählen

• Inline für gelegentliche Links, bei denen die URL kurz ist und der Absatz weiterhin gut lesbar bleibt.
• Referenzstil, wenn Sie dieselbe URL mehrfach zitieren oder wenn die URL ein 200-Zeichen-Tracking-Monster ist, das sonst den Fluss des Absatzes stören würde.
• Autolink für “hier ist unsere Dokumentationsseite”, wo Sie die URL sowohl als Text als auch als Ziel sichtbar haben möchten.

Hygiene bei Sonderzeichen

• Leerzeichen in URLs benötigen %20, sonst bricht der Link am Leerzeichen.
• Klammern in der URL benötigen URL-Kodierung als %28 und %29, andernfalls frisst der Markdown-Parser sie.
• Eckige Klammern im Ankertext müssen als \[ und \] escaped werden, um zu vermeiden, dass der Parser sie als verschachtelte Linksyntax behandelt.

Tipps zur Barrierefreiheit

• Vermeiden Sie “hier klicken”. Ankertexte wie hier klicken oder mehr lesen sind nutzlos, wenn Benutzer von Screenreadern durch Links navigieren. Verwenden Sie beschreibenden Text: [Installationsanleitung](...).
• Setzen Sie die URL selbst nicht als Ankertext für lange URLs, das ist feindlich gegenüber Hilfstechnologien und sieht im Druck schlecht aus.
• In neuem Tab öffnen ist rohes HTML (target="_blank"), nicht Markdown. Die meisten Renderer, die rohes HTML akzeptieren, respektieren es; reines CommonMark nicht.

Einzeiler-Abkürzung

In GitHub-Kommentaren wird das Einfügen einer URL neben ausgewähltem Text automatisch in einen Markdown-Link umgewandelt. Praktisch, wenn Sie sich bereits im Editor befinden.