Ein Bild ist in Markdown ein Link mit einem Ausrufezeichen davor. Das ist die ganze Syntax, und die Ähnlichkeit ist kein Zufall: [Text](url) holt eine Seite,  bettet ein Bild ein.
Ein Bild mit Titel:
Ein Bild, das zugleich ein Link ist:
[](/de/markdown-anleitung)
Ein Bild mit Titel:
Ein Bild, das zugleich ein Link ist:
Der Alternativtext ist nicht optional
Der Text in den eckigen Klammern ist der Alternativtext — die Beschreibung, die ein Screenreader vorliest, und der Text, der erscheint, wenn das Bild nicht lädt. Es ist der Teil der Bildsyntax, den alle überspringen, und derjenige, der am meisten zählt.
Schreib, was das Bild zeigt, nicht was es ist:
Das erste ist für eine blinde Person unsichtbar. Das zweite sagt ihr nichts. Das dritte transportiert den Punkt des Bildes — und genau das liest auch eine Suchmaschine, um es zu verstehen.
Die Ausnahme: Ein rein schmückendes Bild sollte einen leeren Alternativtext bekommen, , damit ein Screenreader es überspringt, statt einen Dateinamen vorzulesen.
Titel
Wie bei Links wird eine Zeichenkette in Anführungszeichen nach dem Pfad zum Tooltip:
Er ist keine Bildunterschrift und kein Ersatz für den Alternativtext — auf Touchgeräten erscheint er überhaupt nicht.
Bilder als Links
Pack das ganze Bild in die Link-Syntax. Die Verschachtelung liest sich beim ersten Mal seltsam:
[](https://apps.apple.com/app/id6752715912)
Der Alternativtext beschreibt jetzt auch das Ziel, also lass ihn sagen, wohin der Klick führt.
Referenzstil
Lange Bildpfade verstopfen einen Absatz genauso wie Link-URLs, und dieselbe Lösung greift:
![Der Editor auf dem Mac][mac-bild]
[mac-bild]: /images/mac-editor.png "Geteilte Ansicht mit Live-Vorschau"
Größe, Ausrichtung und Bildunterschriften
Markdown hat keine Syntax für die Bildgröße. Keine für die Ausrichtung, keine für Bildunterschriften. Das ist Absicht: Markdown beschreibt Inhalt, und wie groß ein Bild ist gehört ins Stylesheet.
Drei ehrliche Möglichkeiten:
- Die Datei verkleinern. Meist die richtige Antwort — ein 4000-px-Foto, das mit 600 px angezeigt wird, ist bei jedem Seitenaufruf verschwendete Bandbreite.
- Mit CSS gestalten, gezielt für die Bilder in deinem Inhaltsbereich. Eine Regel deckt jedes Bild im Dokument ab.
- Rohes HTML nehmen,
<img src="…" width="600" alt="…">, und in Kauf nehmen, dass die Datei kein portables Markdown mehr ist.
Manche Werkzeuge erfinden eine eigene Erweiterung —  und Ähnliches. Das funktioniert in diesem Werkzeug und sonst nirgends. Meide es, wenn du die Datei je bewegen willst.
Für eine Bildunterschrift ist eine Zeile kursiver Text direkt unter dem Bild der übliche Behelf.
Pfade
Relative Pfade sind innerhalb einer Website oder eines Repositories fast immer die bessere Wahl:
Sie funktionieren nach einem Domainwechsel weiter und auch offline. Absolute URLs ergeben Sinn für Bilder, die woanders liegen — aber denk daran: Verschwindet dieser Host, verschwindet dein Bild.
Häufige Fehler
Das ! vergessen. Ohne es bekommst du einen Link auf das Bild statt des Bildes.
Überall leerer Alternativtext. Für Schmuck in Ordnung, für alles Bedeutungstragende ein echtes Versagen in der Barrierefreiheit.
Leerzeichen im Dateinamen. Pfad in spitze Klammern oder Zeichen kodieren, genau wie bei Links.
Erwarten, dass sich das Bild anpasst. Dafür gibt es keine Syntax. Verkleinere die Datei oder schreib eine CSS-Regel.
Auf ein Bild verlinken, das es noch nicht gibt. Die Vorschau zeigt ein kaputtes Symbol, und es rutscht leicht durch. Prüf den Pfad vor dem Veröffentlichen.
Häufige Fragen
Wie füge ich in Markdown ein Bild ein?
Schreib . Das Ausrufezeichen unterscheidet ein Bild von einem Link, die eckigen Klammern tragen den Alternativtext, die runden den Pfad.
Wie ändere ich die Größe eines Bildes in Markdown?
Gar nicht, in Standard-Markdown — es gibt keine Syntax für die Größe. Verkleinere die Bilddatei, ergänz eine CSS-Regel für Bilder in deinem Inhalt, oder weich auf ein HTML-<img> mit width aus, auf Kosten der Portabilität.
Was schreibe ich in den Alternativtext?
Beschreib, was das Bild zeigt und warum es da ist — „Die Downloads verdreifachten sich nach dem März-Release" statt „Diagramm". Ist das Bild rein schmückend, lass den Alternativtext leer, damit Screenreader es überspringen.
Wie mache ich ein Bild anklickbar?
Schachtel das Bild in die Link-Syntax: [](https://example.com). Das Bild wird zum Inhalt des Links.
Kann ich in Markdown eine Bildunterschrift setzen?
Nicht direkt. Üblich ist eine Zeile kursiver Text unmittelbar unter dem Bild. Renderer, die es unterstützen, machen daraus manchmal eine echte <figcaption>; die meisten zeigen sie schlicht als kursiven Text, was ohnehin wie eine Bildunterschrift wirkt.