Markdown구조화

중첩 목록과 들여쓰기

목록 안에 하위 목록, 코드 블록, 문단을 넣을 때 중요한 들여쓰기 규칙을 정리합니다.

마지막 수정 2026년 3월 19일

기본 패턴

text
- 상위 항목
  - 하위 항목
  - 하위 항목

1. 단계
   1. 세부 단계
   2. 세부 단계

설명

  • 목록은 단순히 항목을 나열하는 데서 끝나지 않고, 하위 개념의 포함 관계를 표현할 때 힘을 발휘합니다.
  • 중첩 목록은 들여쓰기 폭을 일관되게 유지하는 것이 핵심입니다.
  • 하위 항목 아래에 코드 블록이나 문단을 넣을 때는 들여쓰기가 더 중요해집니다.
  • 목록이 너무 깊어지면 시각적으로 복잡해지므로, 보통 2단 정도에서 끊고 제목으로 분리하는 편이 읽기 좋습니다.

짧은 예제

text
- 준비물
  - 노트북
  - 충전기
- 해야 할 일
  1. 저장소 clone
  2. README 확인

빠른 정리

항목설명
중첩 bullet하위 개념을 같은 목록 안에서 표현
중첩 번호 목록단계 안의 세부 단계 표현
일관된 들여쓰기렌더링 안정성과 가독성을 함께 좌우
깊이 제한너무 깊은 목록은 제목 분리가 더 낫기도 함
목록 안 코드목록 구조와 코드 들여쓰기를 함께 맞춰야 함

주의할 점

탭과 공백을 섞거나 항목마다 들여쓰기 폭이 달라지면 하위 목록이 깨져 보일 수 있습니다. 목록 문서는 정렬보다 일관성이 더 중요합니다.

참고 링크

2 sources