Links in Markdown

Ein Markdown-Link ist eckige Klammern für den Text und runde für das Ziel, in dieser Reihenfolge. Hast du das, ist der Rest eine Frage davon, wo das Ziel steht — inline, in einer Referenz weiter unten, oder gar nirgends, wenn die URL für sich selbst spricht.

Ein [Inline-Link](https://www.inkiostro.app) ist der übliche.

Ein [Link mit Titel](https://www.inkiostro.app "Fahr mich an") zeigt einen Tooltip.

Ein [Referenzlink][seite] hält den Absatz lesbar.

Eine nackte URL wie https://www.inkiostro.app wird automatisch verlinkt.

[seite]: https://www.inkiostro.app

Inline-Links

[Inkiostro](https://www.inkiostro.app)

Der Text in den Klammern ist das, was die lesende Person sieht und anklickt. Schreib ihn so, dass er auch außerhalb des Zusammenhangs Sinn ergibt: „die Anleitung zu Tabellen" sagt dir, wohin es geht, „hier klicken" nicht. Wer einen Screenreader nutzt, springt oft von Link zu Link, und eine Seite voller „hier" ist unbrauchbar.

Titel

Eine Zeichenkette in Anführungszeichen nach der URL wird zum title-Attribut und erscheint beim Überfahren als Tooltip:

[Inkiostro](https://www.inkiostro.app "Ein Markdown-Editor für Mac, iPad und iPhone")

Nutz das sparsam. Tooltips gibt es auf Touchgeräten überhaupt nicht, ein Titel darf also nie etwas tragen, das die lesende Person braucht.

Referenzlinks

Hat ein Absatz mehrere Links, machen Inline-URLs die Quelle unlesbar. Der Referenzstil schafft sie aus dem Weg:

Lies die [komplette Anleitung][anl], die [Notizen zu Tabellen][tab]
und die [Notizen zu Listen][lst].

[anl]: /de/markdown-anleitung
[tab]: /de/markdown-tabellen
[lst]: /de/markdown-listen

Die Definitionen dürfen überall im Dokument stehen — unten ist üblich. Groß- und Kleinschreibung der Namen spielt keine Rolle, und sie tauchen in der Ausgabe nie auf.

Ist der Linktext selbst der Name, darfst du das zweite Klammerpaar leer lassen:

Lies die [Markdown-Anleitung][] für das ganze Bild.

[Markdown-Anleitung]: /de/markdown-anleitung

Referenzlinks zahlen sich doppelt aus: Der Fließtext bleibt lesbar, und eine zehnmal genutzte URL wird einmal definiert.

Ankerlinks

Auf eine Überschrift im selben Dokument verlinkst du mit # und ihrer erzeugten id — kleingeschrieben, Leerzeichen zu Bindestrichen, Satzzeichen weg:

Spring zu den [Referenzlinks](#referenzlinks).

Über Dokumente hinweg kombinierst du beides: [Tabellen](/de/markdown-tabellen#ausrichtung). Wie die ids entstehen, steht bei den Überschriften.

Automatische Links

Die meisten Renderer machen aus einer nackten URL einen Link. Spitze Klammern machen es ausdrücklich und funktionieren auch dort, wo das automatische Verlinken aus ist:

<https://www.inkiostro.app>

<carlo@appjuice.it>

Eine E-Mail-Adresse in spitzen Klammern wird zu einem mailto:-Link.

Relative Links

Innerhalb einer Website oder eines Repositories verlinkst du über den Pfad statt über die volle URL:

[Die Anleitung zu Listen](/de/markdown-listen)
[Eine Datei daneben](./CONTRIBUTING.md)

Relative Links überstehen einen Domainwechsel und funktionieren offline. Nimm sie für alles innerhalb deines eigenen Projekts.

Häufige Fehler

Klammern vertauscht. (Text)[url] erscheint als wörtlicher Text. Erst eckig, immer.

Ein Leerzeichen dazwischen. [Text] (url) zerbricht den Link. Sie müssen sich berühren.

Leerzeichen in der URL. Pack die URL in spitze Klammern — [Datei](<meine datei.pdf>) — oder kodier das Leerzeichen als %20.

Runde Klammern in der URL. Kommt bei Wikipedia ständig vor. Escape sie als \( und \), oder nimm einen Referenzlink, der das Problem nicht kennt.

„Hier klicken" als Linktext. Schlecht für die Barrierefreiheit, schlecht für Suchmaschinen und nutzlos in einer Liste von Links.

Häufige Fragen

Wie erstelle ich einen Link in Markdown?

Setz den sichtbaren Text in eckige Klammern und das Ziel direkt danach in runde, ohne Leerzeichen dazwischen: [Inkiostro](https://www.inkiostro.app).

Was ist ein Referenzlink in Markdown?

Ein Link, dessen Ziel an anderer Stelle im Dokument definiert ist. Im Fließtext schreibst du [Text][name] und irgendwo, meist unten, auf einer eigenen Zeile [name]: https://example.com. Das hält Absätze lesbar und lässt eine URL viele Links bedienen.

Wie verlinke ich auf einen Abschnitt derselben Seite?

Über den Anker der Überschrift, mit #: [hin](#mein-abschnitt). Der Anker ist der Text der Überschrift, kleingeschrieben, mit Bindestrichen statt Leerzeichen und ohne Satzzeichen.

Wie gehe ich mit einer URL mit Leerzeichen oder Klammern um?

Pack die URL in spitze Klammern — [Text](<meine datei.pdf>) — oder kodier die Zeichen, %20 für ein Leerzeichen. Runde Klammern kannst du außerdem mit einem Backslash escapen oder auf einen Referenzlink ausweichen.

Kann ein Link in Markdown in einem neuen Tab öffnen?

Nicht in Standard-Markdown, das kein target ausdrücken kann. Dafür bräuchtest du rohes HTML, was Portabilität kostet. Die meisten Renderer überlassen die Wahl bewusst der lesenden Person.