07 — Bilder und Anhänge

Ein Bild in ein Dokument einbauen

Laden Sie das Bild neben das Dokument: Ordner öffnen, Datei hinzufügen → Datei hochladen.
Verweisen Sie in der Markdown-Datei darauf:

![Netzwerktopologie](topologie.png)

Der Text in den eckigen Klammern ist die Beschreibung, die erscheint, wenn das Bild nicht geladen werden kann, und die Screenreader vorlesen. Schreiben Sie eine echte Beschreibung, nicht „Bild“.

Wo Bilder liegen sollten

Ein vorhersehbarer Aufbau, der immer funktioniert:

projekt/
  readme.md
  assets/
    topologie.png
    rack.jpg

und in readme.md:

![Netzwerktopologie](assets/topologie.png)

Benennung — die eine Regel

Verwenden Sie für Ordner und Bilddateien Kleinbuchstaben ohne Leerzeichen:

Anfällig	Sicher
`Bildschirmfoto.PNG`	`bildschirmfoto.png`
`1-) Inter-VLAN Notizen/`	`01-inter-vlan/`

Enthält ein Name doch Leerzeichen, schreiben Sie sie im Link als %20:

![Topologie](Bildschirmfoto%20neu.PNG)

Die Größe steuern

Markdown kennt keine Größenangabe; nutzen Sie bei Bedarf einfaches HTML:

<img src="assets/topologie.png" alt="Netzwerktopologie" width="600">

Eine Datei verlinken, statt sie anzuzeigen

Lassen Sie das Ausrufezeichen weg, und Sie erhalten einen Download-Link:

[Packet-Tracer-Datei](main.pkt)

Anhänge in Issues

Ziehen Sie beim Schreiben eines Issues oder Kommentars eine Datei in das Textfeld. Sie wird hochgeladen und der Link automatisch eingefügt. Nutzen Sie das für Screenshots und Logs, die nicht ins Repository selbst gehören.