Quick Syntax

# 제목 1
## 제목 2
### 제목 3

- bullet 항목
- bullet 항목

1. 번호 목록
2. 번호 목록

heading은 글자 크기가 아니라 문서 outline을 표현하고, 목록은 순서가 필요한 절차와 순서 없는 항목을 구분합니다. H1 하나와 H2에서 H3으로 이어지는 계층은 널리 쓰는 문서 convention이지만 Markdown parser의 필수 규칙은 아니므로, renderer의 TOC·sidebar·접근성 검사 결과를 기준으로 일관성을 확인합니다.

문법

제목 수준은 문서 계층을 설계하는 도구이지 글씨 크기 조절 수단이 아니다

# 개수로 정해지는 제목 수준(H1–H6)은 문서의 논리 구조를 나타낸다. 많은 렌더러와 접근성 도구(스크린 리더, 목차 생성기)가 이 계층을 기반으로 동작하기 때문에, 단순히 글자를 크게 보이게 하려고 상위 수준 제목을 남용하면 문서 구조가 무너진다. 일반적으로 H1은 문서 전체의 제목으로 한 번만 쓰고, H2부터 본문 섹션을 시작하는 패턴이 기술 문서에서 가장 흔하다.

# 프로젝트 이름 (H1: 문서 전체 제목, 한 번만)

## 설치 (H2: 주요 섹션)

### macOS (H3: 하위 섹션)

제목 수준을 건너뛰지 않으면 outline을 읽고 점검하기 쉽다

H2 다음에 H4를 쓰는 것처럼 수준을 건너뛰어도 Markdown parser와 대부분의 renderer는 시각적으로 표현한다. 다만 outline이 불연속해지면 사람이 문서 구조를 따라가기 어렵고, lint·sidebar·접근성 도구가 어떤 정책으로 경고하거나 목차를 구성하는지는 제품마다 다르다. 긴 문서에서는 H2 다음에 H3처럼 의미 있는 단계로 이어 쓰고, 실제 사이트의 TOC와 검사 결과를 확인하는 편이 좋다.

<!-- 권고하지 않는 예: H2에서 H4로 건너뜀 -->
## 설치
#### macOS 설정

<!-- 올바른 예: H2 → H3 순서 유지 -->
## 설치
### macOS 설정

순서 없는 목록과 번호 목록은 의미가 다르다

-(또는 *, +)로 시작하는 bullet 목록은 항목 간 순서나 우선순위가 없는 나열에 쓴다. 1.로 시작하는 번호 목록은 순서가 중요한 단계적 절차에 적합하다. 설치 단계처럼 순서를 따라야 하는 내용을 bullet 목록으로 쓰면 독자가 임의 순서로 읽을 수 있다고 오해할 수 있다. 문법 기준으로는 번호 목록의 숫자가 실제 렌더링에서는 자동으로 재정렬되므로, 소스에서 모두 1.로 써도 렌더링에는 문제가 없다.

<!-- 순서 없음: 기능 목록 -->
- 로그인 화면
- 대시보드
- 설정 페이지

<!-- 순서 있음: 설치 절차 -->
1. 저장소를 클론합니다.
2. 의존성을 설치합니다.
3. 서버를 시작합니다.

목록 마커(-, *, +)는 한 문서 안에서 통일하는 것이 협업에 유리하다

CommonMark는 -, *, + 세 가지를 모두 bullet 마커로 허용하지만, 같은 목록 안에서 마커를 섞으면 다른 목록으로 분리될 수 있다. 프로젝트 전체에서 -를 기본으로 통일하면 diff 리뷰에서 변경 의도가 더 명확해지고, linting 도구(markdownlint 등)와도 잘 맞는다.

실무에서는 제목을 시각 크기용으로 쓰거나, 단계 절차를 bullet로 적는 두 실수가 가장 자주 나온다. "이 문장이 섹션 이름인가, 단계인가, 그냥 강조인가"를 먼저 구분하면 대부분의 구조 오류를 초반에 막을 수 있다.

<!-- 같은 목록 안에서 마커 혼용: 렌더러에 따라 분리될 수 있음 -->
- 항목 A
* 항목 B

<!-- 통일된 마커: 안전 -->
- 항목 A
- 항목 B

선택 기준

주의할 점

- 저장소를 클론합니다.
- 의존성을 설치합니다.
- 서버를 시작합니다.

이렇게 쓰면 읽는 사람은 세 항목을 "순서 없는 목록"으로 해석할 수 있습니다. 절차 문서는 번호 목록이 더 안전합니다.