헤딩 — # 부터 ###### 까지

헤딩이 문서의 outline 을 정한다

Markdown 은 # (ATX 스타일) 로 여섯 단계 헤딩 을 지원해. 헤딩은 장식이 아니야 — 문서의 outline 그 자체. 스크린 리더, 목차 생성기, 검색 엔진 모두 헤딩에 의존해.

지킬 규칙

# 뒤에 공백 필수. #heading (공백 없음) 은 CommonMark 에서 헤딩 아님.
닫는 # 는 선택: ## Section ##. 닫는 # 는 잘려나가.
최대 6 단계 — ###### 넘으면 그냥 literal # 들이야.

관행

# H1 은 문서당 정확히 한 번만 — 그게 제목. 나머진 ## 로 주요 섹션, ### 로 서브섹션. 단계 건너뛰지 마 (H2 → H4 는 스크린 리더 망가뜨리고 자동 TOC 깨져).

Setext 스타일 — H1/H2 대체 문법

= 로 밑줄 그으면 H1, - 면 H2. 옛날 문법인데 여전히 유효해. 단 ATX 가 더 흔한 이유: 6 단계 다 되고 소스에서 훑기 쉬워서.

함정: 일부 Markdown 에디터는 #heading (공백 없음) 도 헤딩으로 렌더링하지만, CommonMark 호환 렌더러 (GitHub, pandoc 등) 는 안 해. 배포할 플랫폼에서 테스트해.

Code

ATX 스타일 헤딩·markdown

# Heading 1 — Page title
## Heading 2 — Major section
### Heading 3 — Subsection
#### Heading 4 — Sub-subsection
##### Heading 5 — Minor heading
###### Heading 6 — Smallest heading

Setext 스타일 (H1 / H2 만)·markdown

Main Title
==========

Section Title
-------------

헤딩 — # 부터 ###### 까지

헤딩이 문서의 outline 을 정한다

지킬 규칙

관행

Setext 스타일 — H1/H2 대체 문법

Code

External links

Exercise

Progress

댓글 0