마크다운 숫자 리스트가 1로 초기화될 때? 번호 끊김 해결 방법

마크다운(Markdown) 리스트 작성 시 번호가 초기화(1, 1, 1)되는 현상

주로 리스트 항목 사이에 다른 요소(줄바꿈, 인용문, 코드 블럭 등)가 삽입되어 리스트의 연속성이 끊어졌기 때문임. 이를 해결하기 위한 3가지 기술적 방안을 아래와 같이 보고함.

---

1. 들여쓰기(Indentation)를 통한 연속성 유지 (권장)

가장 표준적인 해결책임. 리스트 항목 사이에 부연 설명이나 코드를 넣을 때, 해당 내용을 스페이스바 4번(혹은 탭 1번) 들여쓰기하여 상위 리스트에 종속된 내용임을 명시해야 함.

• 잘못된 예시 (연속성 끊김)

1. 첫 번째 항목
여기에 설명을 쓰면 리스트가 끊어짐.
2. 두 번째 항목 (이것이 1.로 다시 시작됨)

• 올바른 예시 (들여쓰기로 종속)

1. 첫 번째 항목
    여기에 설명을 쓰면 리스트가 유지됨 (스페이스 4칸 들여쓰기).
2. 두 번째 항목

2. 이스케이프 문자( \ ) 활용 (강제 텍스트 변환)

마크다운의 자동 리스트 렌더링 기능을 비활성화하고, 숫자를 단순 텍스트로 출력하는 방식임. 숫자 뒤의 점(.) 앞에 역슬래시(\)를 입력함.

• 작성법

1\. 첫 번째 항목
중간에 아무 텍스트나 이미지가 들어와도 상관없음.

2\. 두 번째 항목

• 특징: 자동 들여쓰기나 리스트 스타일(HTML <li>)은 적용되지 않으나, 사용자가 입력한 숫자 그대로 출력됨을 보장함.

3. HTML 태그 직접 사용 (start 속성)

마크다운이 지원하지 않는 복잡한 구조일 경우, HTML의 <ol>(Ordered List) 태그를 직접 사용하여 시작 번호를 강제할 수 있음.

• 작성법

<ol start="2">
  <li>두 번째 항목부터 시작</li>
  <li>세 번째 항목</li>
</ol>

• 특징: 리스트가 한 번 끊겼다가 다시 이어져야 할 때 유효함.

---

요약 및 제언

방법	특징	추천 상황
들여쓰기	표준 문법 준수, 들여쓰기 스타일 유지	리스트 내부에 코드나 설명, 이미지를 넣을 때
이스케이프()	리스트 속성 제거, 단순 텍스트화	번호만 유지되면 되고 들여쓰기가 필요 없을 때
HTML 태그	시작 번호 강제 지정 가능	리스트가 완전히 분리된 후 특정 번호로 이어갈 때

---