Markdown 제목 문법
제목은 문서 구조를 구성하는 가장 중요한 요소입니다. Markdown은 두 가지 제목 문법을 지원합니다: ATX 스타일과 Setext 스타일.
ATX 스타일 제목
제목을 만들려면 단어나 구문 앞에 해시(#
)를 추가하세요. 해시의 개수가 제목 수준을 나타냅니다.
markdown
# 제목 수준 1
## 제목 수준 2
### 제목 수준 3
#### 제목 수준 4
##### 제목 수준 5
###### 제목 수준 6
렌더링 결과
제목 수준 1
제목 수준 2
제목 수준 3
제목 수준 4
제목 수준 5
제목 수준 6
선택적 닫는 문법
ATX 스타일 제목을 선택적으로 "닫을" 수 있으며, 이는 순전히 미학적 목적입니다:
markdown
# 제목 수준 1 #
## 제목 수준 2 ##
### 제목 수준 3 ###
끝의 #
개수는 시작 부분과 일치할 필요가 없으며, 시작 부분의 개수가 제목 수준을 결정합니다.
Setext 스타일 제목
텍스트 아래에 임의의 수의 =
기호를 추가하여 1단계 제목을 만들거나, -
기호를 추가하여 2단계 제목을 만들 수도 있습니다.
markdown
제목 수준 1
===============
제목 수준 2
---------------
렌더링 결과
제목 수준 1
제목 수준 2
제목 모범 사례
호환성 고려사항
해시(#
)와 제목 텍스트 사이에 공백이 없으면 다른 Markdown 애플리케이션이 다르게 처리할 수 있습니다. 호환성을 위해 해시와 제목 텍스트 사이에 공백을 추가하세요.
✅ 권장 | ❌ 권장하지 않음 |
---|---|
# 이것은 제목입니다 | #이것은 제목입니다 |
빈 줄 사용
호환성을 위해 제목 앞뒤에 빈 줄을 추가하세요.
markdown
이것은 단락입니다.
# 이것은 제목입니다
이것은 또 다른 단락입니다.
제목 수준
- 각 문서는 하나의 1단계 제목만 사용해야 합니다
- 제목 수준을 논리적으로 유지하고 수준을 건너뛰지 마세요
- 제목은 문서의 구조적 계층을 반영해야 합니다
제목 텍스트 가이드라인
- 제목 텍스트는 간결하고 명확해야 합니다
- 문장 부호(특히 마침표)를 피하세요
- 동명사나 명사구를 사용하세요
- 같은 수준의 제목에 대해 일관된 형식을 유지하세요
HTML 출력
Markdown 제목은 해당하는 HTML 제목 태그로 변환됩니다:
markdown
# 제목 → <h1>제목</h1>
## 제목 → <h2>제목</h2>
### 제목 → <h3>제목</h3>
#### 제목 → <h4>제목</h4>
##### 제목 → <h5>제목</h5>
###### 제목 → <h6>제목</h6>
제목 ID (확장 기능)
많은 Markdown 프로세서가 제목에 대해 자동으로 ID를 생성하며, 이를 사용하여 앵커 링크를 만들 수 있습니다:
html
<h1 id="markdown-heading-syntax">Markdown 제목 문법</h1>
이를 통해 특정 제목에 링크할 수 있습니다:
markdown
[제목으로 링크](#markdown-heading-syntax)
실제 예제
다음은 잘 구성된 제목 계층을 가진 문서의 예제입니다:
markdown
# 사용자 매뉴얼
## 빠른 시작
### 설치 단계
#### 시스템 요구사항
#### 다운로드 및 설치
### 기본 구성
## 고급 기능
### 사용자 정의 설정
### 플러그인 관리
## 문제 해결
### FAQ
### 지원팀 문의
이러한 명확한 제목 구조는 문서를 읽고 탐색하기 쉽게 만듭니다.