기본 패턴
text
[설치로 이동](#설치)
[상위 README](../README.md)
[설정 파일](./config/app.yml)설명
- 섹션 링크는 같은 문서 안 특정 제목으로 바로 이동하게 해 줍니다.
- 상대 경로 링크는 저장소 안 다른 Markdown 파일, 이미지, 설정 파일로 이어질 때 유용합니다.
- 절대 URL보다 상대 경로 링크를 쓰면 저장소 내부 구조가 바뀌지 않는 한 환경에 덜 의존합니다.
- 제목 기반 anchor는 렌더러가 slug를 만드는 방식에 영향을 받으므로, 제목을 크게 바꾸면 링크도 함께 확인해야 합니다.
짧은 예제
text
## 설치
설치 전 [요구 사항](#요구-사항)을 먼저 확인합니다.
자세한 프로젝트 구조는 [가이드](../docs/guide.md)에서 이어서 봅니다.빠른 정리
| 항목 | 설명 |
|---|---|
#section-name | 같은 문서 안 제목으로 이동 |
./file.md | 현재 폴더 기준 상대 경로 |
../file.md | 상위 폴더 기준 상대 경로 |
| 내부 문서 연결 | 저장소 문서 간 탐색이 쉬워짐 |
| 제목 변경 영향 | anchor 이름이 바뀔 수 있어 링크 확인이 필요 |
주의할 점
제목 텍스트를 바꾸면 해당 제목의 anchor도 달라질 수 있습니다. 문서 리팩터링 뒤에는 섹션 링크가 깨지지 않았는지 함께 확인하는 편이 좋습니다.
참고 링크
1 sources