# Anfügen von Dateien mit GitHub CLI

Fügen Sie lokale Bilder und Videos an Probleme, Pullanforderungen und Kommentare an, ohne die Befehlszeile zu verlassen.

Sie können über die Befehlszeile mit GitHub CLI ein lokales Bild oder Video mithilfe der Option `--attach` anhängen.
GitHub CLI lädt die Datei in GitHub hoch und schreibt die resultierende URL in den Text Ihres Issues, Pull Requests oder Kommentars, sodass sie direkt im Text angezeigt wird – genauso, als hätten Sie sie in Ihrem Browser angehängt.

Sie benötigen Pushzugriff auf das Repository, um Dateien anzufügen.

Das `--attach` Flag ist in den folgenden Befehlen verfügbar:

* `gh issue create`
* `gh issue edit`
* `gh issue comment`
* `gh pr create`
* `gh pr edit`
* `gh pr comment`

## Anfügen einer Datei

Übergeben Sie `--attach` mit dem Pfad zu einer lokalen Datei. Ersetzen Sie im folgenden Beispiel ISSUE-NUMBER durch die Anzahl Ihres Problems und PATH/TO/IMAGE durch den Pfad zu Ihrem Bild. Sie können das Flag wiederholen, um mehrere Dateien anzufügen, aber Sie können dieselbe Datei nicht zweimal anfügen.

```shell
gh issue comment ISSUE-NUMBER --attach PATH/TO/IMAGE
```

Sie können `--attach` mit `--body` oder `--body-file` kombinieren, um Bilder und Videos in Ihr Markdown einzubetten. Im folgenden Beispiel werden Platzhalter für den Titel der Pullanforderung, die Markdown-Textkörperdatei und zwei Bilddateien verwendet.

```shell
gh pr create \
  --title "PULL-REQUEST-TITLE" \
  --body-file PATH/TO/BODY-FILE \
  --attach PATH/TO/FIRST-IMAGE \
  --attach PATH/TO/SECOND-IMAGE
```

Wenn Sie Alternativtext für ein Bild festlegen möchten, fügen Sie ihn am Ende des Pfads nach einem `#`, anstelle von ALT-TEXT, hinzu.

```shell
gh issue comment ISSUE-NUMBER --attach 'PATH/TO/IMAGE#ALT-TEXT'
```

Wenn Sie keinen Alternativtext angeben, verwendet GitHub CLI den Dateinamen.

> \[!NOTE]
> Alternativtext wird für Videodateien nicht unterstützt.

## Einbetten eines Anhangs in Markdown

Wenn der Markdown-Text bereits auf eine lokale Datei verweist und Sie dieselbe Datei mit `--attach` anhängen, schreibt GitHub CLI den Verweis direkt um, sodass er auf die hochgeladene Datei verweist, anstatt am Ende eine zweite Kopie anzuhängen. Auf diese Weise können Sie Markdown mit normalen lokalen Pfaden schreiben, lokal eine Vorschau anzeigen, wo die Bilder gerendert werden, und dann unverändert posten. Der Verweis wird unabhängig davon neu geschrieben, wo der Fließtext herkommt: `--body`, `--body-file`, Standardeingabe oder der Texteditor.

### Einbetten eines Bilds

Speichern Sie z. B. den folgenden Inhalt in `PATH/TO/BODY-FILE`:

```markdown
The sign-in screen shows an error where the form should be:

![the sign-in screen showing an authentication error](PATH/TO/IMAGE)
```

Führen Sie den folgenden Befehl mit `--body-file`:

```shell
gh issue comment \
  ISSUE-NUMBER \
  --body-file PATH/TO/BODY-FILE \
  --attach PATH/TO/IMAGE
```

GitHub CLI ersetzt den lokalen Pfad durch die hochgeladene URL und behält Den Markdown- und Alternativtext bei. Wenn ein Verweis neu geschrieben wird, stammt der Alternativtext aus dem Markdown, sodass alle `#` Alternativtexte auf dem Flag nur auf Dateien angewendet werden, die angefügt werden.

Jede angefügte Datei, auf die der Textkörper nicht verweist, wird an das Ende des Textkörpers angefügt, in der Reihenfolge, in der Sie die Flags übergeben haben.

### Einbetten eines Videos

Wenn Sie ein Video als Player einbetten möchten, speichern Sie den folgenden Markdown-Bildverweis in `PATH/TO/VIDEO-BODY-FILE`. Der Verweis muss der einzige Inhalt in seinem Absatz sein.

```markdown
![](PATH/TO/VIDEO)
```

Fügen Sie dann dasselbe Video an:

```shell
gh issue comment \
  ISSUE-NUMBER \
  --body-file PATH/TO/VIDEO-BODY-FILE \
  --attach PATH/TO/VIDEO
```

GitHub CLI ersetzt die gesamte Referenz durch die hochgeladene URL, die als Player angezeigt wird. Wenn der Verweis in einem Satz angezeigt wird, wird er stattdessen als Link gerendert.

## Einschränkungen

Dies GitHub CLI unterstützt nur das Hochladen von Bild- und Mediendateien. Eine Liste der unterstützten Dateitypen finden Sie unter [Anfügen von Dateien](/de/get-started/writing-on-github/working-with-advanced-formatting/attaching-files#image-and-media-files).