{"meta":{"title":"GitHub CLI를 사용하여 파일 첨부","intro":"명령줄을 벗어나지 않고 문제, 끌어오기 요청 및 주석에 로컬 이미지 및 비디오를 첨부합니다.","product":"GitHub CLI","breadcrumbs":[{"href":"/ko/github-cli","title":"GitHub CLI"},{"href":"/ko/github-cli/github-cli","title":"GitHub CLI (GitHub 명령줄 인터페이스)"},{"href":"/ko/github-cli/github-cli/attaching-files-with-github-cli","title":"GitHub CLI를 사용하여 파일 첨부"}],"documentType":"article"},"body":"# GitHub CLI를 사용하여 파일 첨부\n\n명령줄을 벗어나지 않고 문제, 끌어오기 요청 및 주석에 로컬 이미지 및 비디오를 첨부합니다.\n\n명령줄에서 `--attach`를 사용하여 GitHub CLI 플래그로 로컬 이미지 또는 비디오를 첨부할 수 있습니다.\nGitHub CLI 파일을 GitHub 업로드하고 결과 URL을 문제, 끌어오기 요청 또는 주석의 본문에 씁니다. 따라서 브라우저에 첨부한 경우와 마찬가지로 인라인으로 렌더링됩니다.\n\n파일을 첨부하려면 리포지토리에 대한 푸시 액세스 권한이 필요합니다.\n\n플래그는 `--attach` 다음 명령에서 사용할 수 있습니다.\n\n* `gh issue create`\n* `gh issue edit`\n* `gh issue comment`\n* `gh pr create`\n* `gh pr edit`\n* `gh pr comment`\n\n## 파일 첨부\n\n로컬 파일 경로와 함께 `--attach`를 전달하세요. 다음 예제에서는 ISSUE-NUMBER 문제 수로 바꾸고 PATH/TO/IMAGE를 이미지 경로로 바꿉다. 플래그를 반복하여 둘 이상의 파일을 첨부할 수 있지만 동일한 파일을 두 번 첨부할 수는 없습니다.\n\n```shell\ngh issue comment ISSUE-NUMBER --attach PATH/TO/IMAGE\n```\n\n`--body`을(를) `--attach` 또는 `--body-file`와 함께 사용하여 Markdown에 이미지와 동영상을 삽입할 수 있습니다. 다음 예제에서는 끌어오기 요청 제목, Markdown 본문 파일 및 두 개의 이미지 파일에 자리 표시자를 사용합니다.\n\n```shell\ngh pr create \\\n  --title \"PULL-REQUEST-TITLE\" \\\n  --body-file PATH/TO/BODY-FILE \\\n  --attach PATH/TO/FIRST-IMAGE \\\n  --attach PATH/TO/SECOND-IMAGE\n```\n\n이미지에 대한 대체 텍스트를 설정하려면 ALT-TEXT 대신 경로 `#`의 끝에 추가합니다.\n\n```shell\ngh issue comment ISSUE-NUMBER --attach 'PATH/TO/IMAGE#ALT-TEXT'\n```\n\n대체 텍스트를 GitHub CLI 제공하지 않으면 파일 이름을 사용합니다.\n\n> \\[!NOTE]\n> 대체 텍스트는 비디오 파일에서 지원되지 않습니다.\n\n## Markdown에 첨부 파일 포함\n\nMarkdown 텍스트가 이미 로컬 파일을 참조하고 동일한 파일을 `--attach`GitHub CLI 첨부하는 경우 마지막에 두 번째 복사본을 추가하는 대신 업로드된 파일을 가리키도록 참조를 다시 작성합니다. 이렇게 하면 일반 로컬 경로를 사용하여 Markdown을 작성하고, 이미지가 렌더링되는 위치에서 로컬로 미리 본 다음, 변경되지 않은 상태로 게시할 수 있습니다. 본문 텍스트의 출처가 `--body`, `--body-file`, 표준 입력 또는 텍스트 편집기인지와 관계없이 참조는 다시 작성됩니다.\n\n### 이미지 포함\n\n예를 들어 다음 콘텐츠를 다음과 같이 저장합니다.`PATH/TO/BODY-FILE`\n\n```markdown\nThe sign-in screen shows an error where the form should be:\n\n![the sign-in screen showing an authentication error](PATH/TO/IMAGE)\n```\n\n다음 명령을 사용하여 실행합니다.`--body-file`\n\n```shell\ngh issue comment \\\n  ISSUE-NUMBER \\\n  --body-file PATH/TO/BODY-FILE \\\n  --attach PATH/TO/IMAGE\n```\n\nGitHub CLI 는 로컬 경로를 업로드된 URL로 바꾸고 Markdown 및 대체 텍스트를 유지합니다. 참조를 다시 작성하면 대체 텍스트가 Markdown에서 제공되므로 플래그의 모든 `#` 대체 텍스트는 추가된 파일에만 적용됩니다.\n\n본문에서 참조하지 않는 첨부 파일은 플래그를 전달한 순서대로 본문 끝에 추가됩니다.\n\n### 비디오 포함\n\n비디오를 플레이어로 포함하려면 다음 Markdown 이미지 참조를 저장합니다 `PATH/TO/VIDEO-BODY-FILE`. 참조는 해당 단락의 유일한 콘텐츠여야 합니다.\n\n```markdown\n![](PATH/TO/VIDEO)\n```\n\n그런 다음, 동일한 비디오를 첨부합니다.\n\n```shell\ngh issue comment \\\n  ISSUE-NUMBER \\\n  --body-file PATH/TO/VIDEO-BODY-FILE \\\n  --attach PATH/TO/VIDEO\n```\n\nGitHub CLI 는 전체 참조를 업로드된 URL로 바꿉니다. 이 URL은 플레이어로 렌더링됩니다. 참조가 문장 내에 나타나면 대신 링크로 렌더링됩니다.\n\n## Limitations\n\nGitHub CLI 이미지 및 미디어 파일 업로드만 지원합니다. 지원되는 파일 형식 목록은 [파일 첨부](/ko/get-started/writing-on-github/working-with-advanced-formatting/attaching-files#image-and-media-files)을 참조하세요."}