Bilder in Markdown mit Kontext verwenden
Wähle verlässliche Bildquellen, schreibe hilfreiche Beschreibungen und prüfe das exportierte Markdown-Bild vor dem Teilen.
Ein Bild in Markdown braucht mehr als einen funktionierenden Link. Leser müssen verstehen, was es zeigt, warum es dort steht und wo die bearbeitbare Quelle liegt. Prüfe mit dem Markdown-Konverter die gesamte Zusammenstellung, bevor du sie als Bild teilst.
Eine Illustration sollte einen Punkt erklären, den der Begleittext tatsächlich behandelt. Eine Release-Checkliste kann etwa eine noch offene Prüfung zeigen. Ein dekoratives Laptopfoto vermittelt diesen Status nicht. Platziere die Erklärung beim Bild, damit Leser seine Bedeutung nicht erraten müssen.
In der Markdown-Bildsyntax steht die Beschreibung in eckigen Klammern und die Quelle in runden Klammern. Die CommonMark-Spezifikation beschreibt diesen Aufbau. Ein hilfreicher Text benennt das im Zusammenhang Wesentliche, statt einen Dateinamen zu wiederholen oder nur „Bild“ zu sagen.
Die Demonstration verwendet ein bereitgestelltes Checklistenbild. Lass Beschreibung und nachfolgenden Satz zusammen: Die Beschreibung erklärt das Motiv, der Satz die weitere Bearbeitbarkeit der Quelle.
# Image with useful context
The source document remains editable; the exported card is for sharing.
Das Ergebnis kombiniert Bild und Text für ein internes Prüfungsupdate. Es ist keine bearbeitbare Kopie der ursprünglichen Checkliste. Ist der offene Punkt entscheidend, erwähne ihn auch im begleitenden Beitrag.
Öffne zuerst die Bild-URL direkt und prüfe, ob sie das richtige Bild liefert. Eine kopierte Adresse kann auf eine Freigabeseite, einen abgelaufenen Link oder eine nur in deiner angemeldeten Sitzung zugängliche Datei zeigen. Ein relativer Pfad aus einem Repository lässt sich nicht automatisch in einen eigenständigen Webeditor übertragen.
Verwende eine Quelle, die du kontrollierst und teilen darfst. Veröffentliche keinen privaten Screenshot, nur um das Laden zu ermöglichen: Schwärze vertrauliche Inhalte oder nimm ein unbedenkliches Demobild. Prüfe nach dem Austausch der URL den Zugriff erneut und kontrolliere die Vorschau vor dem Export.
Kleine Beschriftungen auf einem breiten Screenshot können unlesbar bleiben, obwohl die äußere Karte ordentlich aussieht. Schneide unwichtige Oberflächenbereiche weg und behalte den erklärenden Ausschnitt. Vergrößere keine winzige Vorlage. Höhere Exportabmessungen stellen fehlende Originaldetails nicht wieder her.
Prüfe nach dem Download das eingebettete Bild und den Begleittext in der späteren Anzeigegröße. Veröffentliche außerdem eine zugängliche Texterklärung. Die Beschreibung in der Markdown-Quelle ersetzt nicht den Alternativtext des fertigen Exportbildes.
Prüfe dein Markdown mit Bildern vor der Veröffentlichung.
Weitere Anleitungen: zwei Bilder nebeneinander anordnen und Markdown als PNG exportieren.