각주
각주는 Markdown의 확장 기능으로, 문서에 참조 메모나 보충 정보를 추가할 수 있게 하여 독자가 읽기 흐름을 방해하지 않고 추가 설명을 볼 수 있도록 합니다.
기본 문법
각주 추가
Markdown에서 각주 생성은 두 부분으로 구성됩니다: 각주 표시와 각주 내용.
이것은 각주가 포함된 단락입니다[^1].
[^1]: 이것은 각주의 내용입니다.렌더링 효과:
이것은 각주가 포함된 단락입니다[^1].
[^1]: 이것은 각주의 내용입니다.
여러 개의 각주
Markdown은 John Gruber이 만든 경량 마크업 언어[^1]로, 현재 글쓰기에 널리 사용됩니다[^2].
[^1]: Markdown은 간단한 문법을 사용하여 텍스트 형식을 구현합니다.
[^2]: John Gruber은 2004년에 Markdown을 만들었습니다.
[^3]: GitHub, Stack Overflow, 블로그 플랫폼 등 많은 플랫폼이 Markdown을 지원합니다.렌더링 효과:
Markdown은 John Gruber이 만든 경량 마크업 언어[^2]로, 현재 글쓰기에 널리 사용됩니다[^4].
[^2]: Markdown은 간단한 문법을 사용하여 텍스트 형식을 구현합니다. [^3]: John Gruber은 2004년에 Markdown을 만들었습니다. [^4]: GitHub, Stack Overflow, 블로그 플랫폼 등 많은 플랫폼이 Markdown을 지원합니다.
고급 사용법
각주 식별자
각주 식별자는 숫자나 단어일 수 있지만, 공백이나 탭을 포함할 수 없습니다.
여기에 일반적인 각주[^1]와 식별자가 있는 각주[^note]가 있습니다.
[^1]: 이것은 일반적인 각주입니다.
[^note]: 이것은 식별자가 있는 각주입니다.렌더링 효과:
여기에 일반적인 각주[^5]와 식별자가 있는 각주[^note]가 있습니다.
[^5]: 이것은 일반적인 각주입니다. [^note]: 이것은 식별자가 있는 각주입니다.
다단락 각주
각주 내용은 여러 단락이나 다른 요소를 포함할 수 있으며, 적절한 들여쓰기가 필요합니다.
이것은 여러 단락을 포함하는 각주입니다[^multipara].
[^multipara]: 이것은 각주의 첫 번째 단락입니다.
이것은 각주의 두 번째 단락입니다. 최소 4개의 공백이나 1개의 탭으로 들여쓰기하세요.
> 각주에 인용문도 포함할 수 있습니다.
- 각주에 목록도 포함할 수 있습니다
- 순서 있는 목록과 순서 없는 목록 모두 지원됩니다렌더링 효과:
이것은 여러 단락을 포함하는 각주입니다[^multipara].
[^multipara]: 이것은 각주의 첫 번째 단락입니다.
이것은 각주의 두 번째 단락입니다. 최소 4개의 공백이나 1개의 탭으로 들여쓰기하세요.
> 각주에 인용문도 포함할 수 있습니다.
- 각주에 목록도 포함할 수 있습니다
- 순서 있는 목록과 순서 없는 목록 모두 지원됩니다
인라인 각주
일부 Markdown 구현은 인라인 각주 문법을 지원하지만, 이는 표준 Markdown의 일부가 아닙니다.
이것은 인라인 각주입니다^[문서 끝이 아닌 텍스트에 직접 각주 내용을 추가합니다].렌더링 효과 (지원되는 플랫폼에서):
이것은 인라인 각주입니다^[문서 끝이 아닌 텍스트에 직접 각주 내용을 추가합니다].
호환성 및 구현 차이
다양한 플랫폼의 지원 상태
| 플랫폼/도구 | 표준 각주 | 인라인 각주 | 다단락 각주 |
|---|---|---|---|
| GitHub Markdown | ✅ | ❌ | ✅ |
| GitLab Markdown | ✅ | ✅ | ✅ |
| Jekyll (kramdown) | ✅ | ✅ | ✅ |
| Hugo | ✅ | ✅ | ✅ |
| CommonMark | ❌ | ❌ | ❌ |
| VitePress | ✅ | ✅ | ✅ |
| Pandoc | ✅ | ✅ | ✅ |
HTML 출력 형식
대부분의 Markdown 프로세서는 각주를 링크와 되돌아가기 화살표가 있는 HTML로 변환합니다:
<!-- 각주 참조 -->
<p>이것은 각주가 포함된 단락입니다<sup id="fnref:1"><a href="#fn:1" class="footnote-ref">1</a></sup>.</p>
<!-- 각주 내용 (보통 문서 끝에 위치) -->
<div class="footnotes">
<hr>
<ol>
<li id="fn:1">
<p>이것은 각주의 내용입니다.<a href="#fnref:1" class="footnote-backref">↩</a></p>
</li>
</ol>
</div>사용 권장사항 및 모범 사례
각주를 사용해야 할 때
각주는 다음 상황에 적합합니다:
- 출처 인용: 연구 논문, 책 또는 기타 참고 자료 인용
- 보충 설명: 주요 내용을 방해하지 않고 추가 정보 제공
- 추가 읽기: 관심 있는 독자를 위한 더 많은 자료 제공
- 용어 설명: 기술 용어나 약어 설명
각주 타이포그래피 제안
✅ 권장 사례:
1. **각주 내용을 끝에 배치**: 모든 각주 정의를 문서 끝에 배치하여 유지보수 용이
2. **일관성 유지**: 일관된 각주 표시 방법 사용 (숫자 또는 의미 있는 식별자)
3. **적절히 사용**: 너무 많은 각주는 독자를 산만하게 할 수 있음
4. **의미 있는 내용 제공**: 각주는 실제 가치를 추가해야 하며, 주요 텍스트를 단순히 반복하면 안 됨
❌ 피해야 할 사례:
1. 단일 문장에 여러 각주 사용
2. 핵심 정보 표시에 각주 사용
3. 각주에 너무 긴 내용 배치
4. 각주 내에 각주 중첩긴 문서의 각주
매우 긴 문서의 경우, 장별로 각주를 그룹화할 수 있습니다:
# 1장
이것은 1장의 내용으로, 각주가 포함되어 있습니다[^1-1].
[^1-1]: 1장의 첫 번째 각주.
# 2장
이것은 2장의 내용으로, 다른 각주가 포함되어 있습니다[^2-1].
[^2-1]: 2장의 첫 번째 각주.일반적인 문제 해결
각주가 표시되지 않음
각주가 올바르게 표시되지 않는 경우:
- 각주 식별자와 각주 정의가 정확히 일치하는지 확인 (대소문자 포함)
- 각주 정의가 올바른 형식인지 확인 (콜론 뒤에 공백 필요)
- Markdown 프로세서가 각주 문법을 지원하는지 확인
- 각주 정의 전후에 빈 줄을 두어 시도
각주 번호 혼란
일부 프로세서는 사용자 정의 식별자를 사용해도 각주를 자동으로 다시 번호를 매깁니다. 이는 예상되는 동작이며, 최종 표시는 보통 연속된 숫자입니다.
모바일 기기에서의 사용성
모바일 기기에서는 각주 링크가 작고 클릭하기 어려울 수 있습니다. 각주 호버 미리보기를 지원하는 리더를 사용하면 이 문제를 개선할 수 있습니다.
관련 문법
연습 및 적용
- 최소 3개의 서로 다른 각주가 포함된 짧은 글 작성
- 다단락 내용이 있는 각주 생성 시도
- 학술 또는 기술 글에서 참고 자료 인용에 각주 사용
각주는 Markdown 문서의 전문성과 신뢰성을 향상시키는 중요한 도구입니다. 주요 내용 흐름을 방해하지 않고 추가 정보를 제공할 수 있어 문서를 더욱 완전하고 권위 있게 만듭니다.