마크다운 번호 목록 — 순서 목록 문법과 예제

마크다운 번호 목록은 원 사양에서 하나의 생각을 물려받았습니다. 첫 숫자가 시작 값을 정하고, 렌더러가 항목을 스스로 셉니다. 모든 행이 1.으로 시작하는 목록은 1, 2, 3, 4로 렌더링됩니다. 써보기 전까지는 버그처럼 들리지만, 써보면 납득이 갑니다. 전부 1. 패턴에서는 중간 삽입이 다시 매기기를 요구하지 않고, 삭제가 구멍을 남기지 않습니다. 많은 대형 문서 프로젝트가 바로 이 이유로 이 패턴을 스타일 가이드에 못 박았습니다.

계약에는 알아둘 조항이 하나 있습니다. 소스 숫자의 실제 점프는 시작에서만 존중됩니다. 5.로 시작하는 마크다운 번호 목록은 렌더링 카운트가 5에서 시작하지만, 이후 행을 42.로 시작해도 아무 것도 바뀌지 않습니다. 정확하고 눈에 보이는 번호가 중요한 자리 — 법률 조항, 계약 세부 항목 — 에서는 소스 숫자를 믿지 말고 렌더링 결과를 확인하세요. 놀이터의 미리보기는 여러분이 조립한 목록의 렌더링 번호를 보여 줍니다. 이 페이지가 가르치고 싶은 습관입니다.

마지막으로 들일 습관 하나. 마크다운 번호 목록의 각 항목은 구조적으로 병렬로 유지하세요. 한 문장, 같은 목소리, 같은 대소문자. 병렬 항목은 눈에 빨리 들어오고, 언젠가 목록이 PDF나 슬라이드로 바뀔 때 균일한 항목은 손질 없이 형식 변화를 살아남습니다. 위의 빌더는 입력하는 동안 그 리듬을 보여 줍니다.

목록이 자주 바뀌는 문서라면 전부 1. 패턴이 유지보수에 압도적으로 유리합니다. 항목을 삽입하고 삭제할 때마다 번호를 다시 매기는 수고가 사라지고, diff에는 실제로 바뀐 내용만 나타납니다. 번호는 어차피 렌더러가 정확하게 매겨 줍니다.

반대로 법률 문서처럼 번호 자체가 의미를 갖는 경우에는 실제 번호를 소스에 그대로 쓰고, 렌더링 결과를 반드시 확인하세요. 어떤 방식을 택하든 위의 놀이터에서 최종 모습을 한 번 보고 넘어가면 안심할 수 있습니다.

번호 목록은 문서의 뼈대 중 하나입니다. 절차 설명, 요구사항 나열, 단계 안내 — 순서가 의미를 갖는 모든 곳에서 번호 목록이 그 구조를 실어 나릅니다. 항목을 병렬로 유지하고 마커를 일관되게 쓰는 두 가지 규칙만 지키면 번호 목록은 어떤 문서에서도 가장 단단한 부분이 됩니다.