목록 문법

목록은 정보를 정리하는 중요한 방법입니다. Markdown은 순서 없는 목록, 순서 있는 목록, 중첩 목록, 작업 목록을 지원합니다.

순서 없는 목록

기본 문법

-, *, +를 사용하여 순서 없는 목록을 만듭니다:

markdown

- 항목 1
- 항목 2
- 항목 3

* 항목 1
* 항목 2
* 항목 3

+ 항목 1
+ 항목 2
+ 항목 3

렌더링 결과:

항목 1
항목 2
항목 3

기호 선택 조언

기호	특징	권장 상황
`-`	가장 일반적, 간결함	일반적으로 권장
`*`	강조 문법과 일관성	스타일 일관성 필요 시
`+`	드물게 사용	특별한 구분 필요 시

팁: 문서 전체에서 기호를 일관되게 사용하세요.

순서 있는 목록

기본 문법

숫자와 마침표를 사용하여 순서 있는 목록을 만듭니다:

markdown

1. 첫 번째 항목
2. 두 번째 항목
3. 세 번째 항목

렌더링 결과:

첫 번째 항목
두 번째 항목
세 번째 항목

번호 매기기

숫자의 실제 값은 중요하지 않으며, Markdown이 자동으로 올바른 순서를 생성합니다:

markdown

1. 첫 번째 항목
3. 두 번째 항목
8. 세 번째 항목

렌더링 결과:

첫 번째 항목
두 번째 항목
세 번째 항목

시작 번호 지정

시작 번호를 지정할 수 있습니다:

markdown

3. 세 번째 항목
4. 네 번째 항목
5. 다섯 번째 항목

렌더링 결과:

세 번째 항목
네 번째 항목
다섯 번째 항목

중첩 목록

기본 중첩

들여쓰기(2~4칸)를 사용하여 중첩 목록을 만듭니다:

markdown

- 1단계 항목 1
  - 2단계 항목 1.1
  - 2단계 항목 1.2
- 1단계 항목 2
  - 2단계 항목 2.1
    - 3단계 항목 2.1.1
    - 3단계 항목 2.1.2
  - 2단계 항목 2.2

렌더링 결과:

1단계 항목 1
- 2단계 항목 1.1
- 2단계 항목 1.2
1단계 항목 2
- 2단계 항목 2.1
  - 3단계 항목 2.1.1
  - 3단계 항목 2.1.2
- 2단계 항목 2.2

혼합 중첩

순서 있는 목록과 순서 없는 목록을 서로 중첩할 수 있습니다:

markdown

1. 순서 있는 항목 1
   - 순서 없는 하위항목 1.1
   - 순서 없는 하위항목 1.2
2. 순서 있는 항목 2
   1. 순서 있는 하위항목 2.1
   2. 순서 있는 하위항목 2.2
      - 순서 없는 하위하위항목 2.2.1
      - 순서 없는 하위하위항목 2.2.2

렌더링 결과:

순서 있는 항목 1
- 순서 없는 하위항목 1.1
- 순서 없는 하위항목 1.2
순서 있는 항목 2
1. 순서 있는 하위항목 2.1
2. 순서 있는 하위항목 2.2
  - 순서 없는 하위하위항목 2.2.1
  - 순서 없는 하위하위항목 2.2.2

목록 내 다단락 내용

단락 이어쓰기

목록 항목 내에 여러 단락을 포함할 수 있습니다:

markdown

1. 첫 번째 항목

   첫 번째 항목의 두 번째 단락입니다. 들여쓰기를 통해 목록 항목 내에 포함시킵니다.

2. 두 번째 항목

   두 번째 항목의 두 번째 단락입니다.
   
   두 번째 항목의 세 번째 단락입니다.

3. 세 번째 항목

렌더링 결과:

첫 번째 항목
첫 번째 항목의 두 번째 단락입니다. 들여쓰기를 통해 목록 항목 내에 포함시킵니다.
두 번째 항목
두 번째 항목의 두 번째 단락입니다.
두 번째 항목의 세 번째 단락입니다.
세 번째 항목

코드 블록

목록 내에 코드 블록을 포함할 수 있습니다:

markdown

1. 의존성 설치

   ```bash
   npm install express

서버 생성

javascript

const express = require('express');
const app = express();

서버 시작


### 인용문

목록 내에 인용문을 포함할 수 있습니다:

```markdown
1. 준비

   > 디스크 공간이 충분한지 확인하세요
   > 최소 10GB 권장

2. 설치 시작

작업 목록

기본 문법

- [ ]는 미완료, - [x]는 완료된 작업을 나타냅니다:

markdown

- [x] 완료된 작업
- [ ] 미완료 작업
- [x] 또 다른 완료된 작업
- [ ] 할 일 항목

렌더링 결과:

[x] 완료된 작업
[ ] 미완료 작업
[x] 또 다른 완료된 작업
[ ] 할 일 항목

중첩 작업 목록

markdown

- [x] 프로젝트 기획
  - [x] 요구사항 분석
  - [x] 기술 조사
  - [ ] 프로토타입 설계
- [ ] 개발 단계
  - [ ] 프론트엔드 개발
    - [x] 페이지 레이아웃
    - [ ] 인터랙티브 기능
  - [ ] 백엔드 개발
    - [ ] API 설계
    - [ ] 데이터베이스 설계
- [ ] 테스트 단계

렌더링 결과:

[x] 프로젝트 기획
- [x] 요구사항 분석
- [x] 기술 조사
- [ ] 프로토타입 설계
[ ] 개발 단계
- [ ] 프론트엔드 개발
  - [x] 페이지 레이아웃
  - [ ] 인터랙티브 기능
- [ ] 백엔드 개발
  - [ ] API 설계
  - [ ] 데이터베이스 설계
[ ] 테스트 단계

공통 오류 및 해결 방법

1. 불일치 들여쓰기

markdown

❌ 오류: 불일치 들여쓰기
- 항목 1
  - 하위항목 1.1
    - 하위항목 1.2  ← 들여쓰기 오류

✅ 올바른: 일관된 들여쓰기
- 항목 1
  - 하위항목 1.1
  - 하위항목 1.2

2. 목록 항목 사이의 불필요한 빈 줄

markdown

❌ 오류: 불필요한 빈 줄이 목록을 깨뜨림
- 항목 1

- 항목 2  ← 이는 두 개의 별도 목록을 생성합니다

✅ 올바른: 연속 목록 항목
- 항목 1
- 항목 2

3. 번호 뒤의 공백 누락

markdown

❌ 오류:
1.First item  ← 공백 누락
2.Second item

✅ 올바른:
1. First item
2. Second item

특별한 경우

목록 기호 이스케이프

목록 기호를 줄 시작에 표시하고 목록을 만들지 않으려면:

markdown

\- 이것은 목록 항목이 아닙니다
\* 이것은 목록 항목이 아닙니다
\1. 이것은 순서 있는 목록 항목이 아닙니다

렌더링 결과:

- 이것은 목록 항목이 아닙니다 * 이것은 목록 항목이 아닙니다 \1. 이것은 순서 있는 목록 항목이 아닙니다

목록 항목 내 코드

markdown

- Install `npm install package-name`
- Run `npm start`
- Visit `http://localhost:3000` in your browser

렌더링 결과:

Install npm install package-name
Run npm start
Visit http://localhost:3000 in your browser

목록 항목 내 링크

markdown

- [GitHub](https://github.com) - Code hosting platform
- [Stack Overflow](https://stackoverflow.com) - Q&A site
- [MDN](https://developer.mozilla.org) - Developer documentation

렌더링 결과:

GitHub - Code hosting platform
Stack Overflow - Q&A site
MDN - Developer documentation

최선의 사례

1. 일관성 유지

markdown

✅ 권장: 항상 대시 사용
- 항목 A
- 항목 B
- 항목 C

❌ 권장하지 않음: 기호 혼합
- 항목 A
* 항목 B
+ 항목 C

2. 중첩 적절히 사용

markdown

✅ 권장: 적절한 중첩
- 주요 기능
  - 사용자 관리
  - 콘텐츠 관리
- 보조 기능
  - 로깅
  - 데이터 백업

❌ 권장하지 않음: 너무 깊은 중첩
- 기능
  - 주요 기능
    - 핵심 기능
      - 기본 기능  ← 너무 깊음

3. 의미론적 구성

markdown

✅ 권장: 논리적 그룹화
## 개발 도구
- 코드 에디터
- 버전 제어
- 디버깅 도구

## 디자인 도구
- 프로토타이핑
- 이미지 편집
- UI 디자인

❌ 권장하지 않음: 논리적 그룹화 없음
- 코드 에디터
- 프로토타이핑
- 버전 제어
- 이미지 편집

HTML 출력

Markdown 목록은 HTML로 변환됩니다:

markdown

- 항목 1
- 항목 2

변환된:

html

<ul>
  <li>항목 1</li>
  <li>항목 2</li>
</ul>

markdown

1. 항목 1
2. 항목 2

변환된:

html

<ol>
  <li>항목 1</li>
  <li>항목 2</li>
</ol>

실제 예시

쇼핑 목록

markdown

## 오늘의 쇼핑 목록

### 일상 필요
- [ ] 샴푸
- [ ] 치약
- [x] 수건

### 식비
- [ ] 우유
- [ ] 빵
- [x] 달걀
- [ ] 과일
  - [ ] 사과
  - [x] 바나나
  - [ ] 오렌지

학습 계획

markdown

## 이번 달 학습 계획

1. **주차 1**: 기초
   - [x] 튜토리얼 1-3장 읽기
   - [x] 연습 문제 1-10
   - [ ] 동영상 강의 1-5

2. **주차 2**: 프로젝트 실습
   - [ ] 간단한 프로젝트 만들기
   - [ ] 기본 기능 구현
   - [ ] 스타일 디자인 추가

3. **주차 3**: 고급 콘텐츠
   - [ ] 고급 기능 학습
   - [ ] 프로젝트 성능 최적화
   - [ ] 테스트 케이스 작성

4. **주차 4**: 검토
   - [ ] 학습 노트 정리
   - [ ] 최종 프로젝트 준비
   - [ ] 주요 콘텐츠 검토

API 기능 목록

markdown

## API 엔드포인트

### 사용자 관리
1. `GET /api/users` - 사용자 목록 조회
   - 페이지네이션 지원
   - 검색 필터링 지원
   
2. `POST /api/users` - 새 사용자 생성
   - 관리자 권한 필요
   - 이메일 고유성 검증
   
3. `PUT /api/users/:id` - 사용자 정보 수정
   - 사용자는 자신의 정보만 수정 가능
   - 관리자는 모든 사용자 정보 수정 가능

### 콘텐츠 관리
- `GET /api/posts` - 게시물 목록 조회
- `POST /api/posts` - 새 게시물 생성
- `DELETE /api/posts/:id` - 게시물 삭제

연습

다음 유형의 목록을 만드세요:

3단계 중첩 프로젝트 구조
코드 예시가 포함된 기술 단계 목록
순서 있는 목록과 순서 없는 목록이 혼합된 복잡한 목록
작업 상태가 포함된 프로젝트 체크리스트

목록 문법 ​

순서 없는 목록 ​

기본 문법 ​

기호 선택 조언 ​

순서 있는 목록 ​

기본 문법 ​

번호 매기기 ​

시작 번호 지정 ​

중첩 목록 ​

기본 중첩 ​

혼합 중첩 ​

목록 내 다단락 내용 ​

단락 이어쓰기 ​

코드 블록 ​

작업 목록 ​

기본 문법 ​

중첩 작업 목록 ​

공통 오류 및 해결 방법 ​

1. 불일치 들여쓰기 ​

2. 목록 항목 사이의 불필요한 빈 줄 ​

3. 번호 뒤의 공백 누락 ​

특별한 경우 ​

목록 기호 이스케이프 ​

목록 항목 내 코드 ​

목록 항목 내 링크 ​

최선의 사례 ​

1. 일관성 유지 ​

2. 중첩 적절히 사용 ​

3. 의미론적 구성 ​

HTML 출력 ​

실제 예시 ​

쇼핑 목록 ​

학습 계획 ​

API 기능 목록 ​

관련 문법 ​

연습 ​

목록 문법

순서 없는 목록

기본 문법

기호 선택 조언

순서 있는 목록

기본 문법

번호 매기기

시작 번호 지정

중첩 목록

기본 중첩

혼합 중첩

목록 내 다단락 내용

단락 이어쓰기

코드 블록

작업 목록

기본 문법

중첩 작업 목록

공통 오류 및 해결 방법

1. 불일치 들여쓰기

2. 목록 항목 사이의 불필요한 빈 줄

3. 번호 뒤의 공백 누락

특별한 경우

목록 기호 이스케이프

목록 항목 내 코드

목록 항목 내 링크

최선의 사례

1. 일관성 유지

2. 중첩 적절히 사용

3. 의미론적 구성

HTML 출력

실제 예시

쇼핑 목록

학습 계획

API 기능 목록

관련 문법

연습