기본 패턴
text
Visit https://github.com
#123
owner/repo#456
a5c3785설명
- GitHub는 표준 URL을 자동으로 링크로 바꿔 줍니다.
- 대화 영역에서는
#123,owner/repo#456, 커밋 SHA처럼 저장소 문맥이 있는 참조도 자동 링크로 바뀔 수 있습니다. - 이런 자동 링크는 이슈, PR, 커밋을 짧게 참조하게 해 주어 협업 문서를 훨씬 읽기 쉽게 만듭니다.
- 다만 이슈 번호 단축 참조는 모든 Markdown 파일이 아니라 GitHub 대화 맥락에서 특히 강하게 동작합니다.
짧은 예제
text
배포 오류는 #128에서 추적 중입니다.
원인 분석은 org/app#532와 커밋 a5c3785를 같이 확인하세요.
문서는 https://docs.github.com 에서 볼 수 있습니다.빠른 정리
| 항목 | 설명 |
|---|---|
| 일반 URL | GitHub가 자동으로 링크 처리 |
#123 | 같은 저장소 이슈/PR 참조 |
owner/repo#123 | 다른 저장소 이슈/PR 참조 |
| commit SHA | 짧은 커밋 링크로 렌더링 가능 |
| 문맥 의존성 | 이슈/PR 참조는 GitHub 대화 영역에서 특히 유용 |
주의할 점
자동 링크는 편리하지만, 저장소 문맥이 없는 일반 Markdown 환경에서는 같은 방식으로 동작하지 않을 수 있습니다. README와 이슈 코멘트의 차이를 함께 생각하는 편이 좋습니다.
참고 링크
2 sources