마크다운 들여쓰기 — 목록과 코드 블록

마크다운은 문서를 블록으로 분석하고, 각 블록 형식은 자기만의 들여쓰기 계약을 지닙니다. 목록 블록은 중첩과 연속을 위해 맞춰진 마크다운 들여쓰기를 환영하고, 문단은 그것을 허용했다 버리고, 네 칸 깊이에서 시작하는 새 블록은 1990년대 이메일 인용에서 물려받은 관습에 따라 미리 서식된 코드로 추정됩니다. 렌더러는 여러분의 의도를 결코 묻지 않습니다. 지금 있는 블록의 계약을 적용할 뿐입니다.

실용적인 기억 후크는 '네까지 세기'입니다. 목록 마커 뒤의 한세 칸은 중첩 또는 연속. 빈 공간의 네 칸은 코드. 목록 항목 바로 아래의 네 칸은 항목 안의 중첩 코드 — 사람을 가장 놀라게 하는 것이고, '들여쓴 코드' 예제가 무해하게 시연합니다. 의심스러울 때는 백틱 코드 펜스를 선호하세요. 펜스는 모호하지 않고, 복사-붙여넣기를 살아남고, 강조 표시용 언어를 선언합니다.

마크다운 들여쓰기가 몸에 밴 뒤에는 목록 설계가 추측이 아니게 됩니다. 깊은 중첩은 실무에서 수준마다 두 칸과 네 칸을 번갈아 쌓고, 마크다운 번호 목록 페이지는 같은 정렬 규칙 위에 번호 규칙을 얹습니다. 두 페이지 모두 이 사이트의 실시간 엔진을 공유하므로, 여기서 검증한 동작은 저기서도 믿을 수 있는 동작입니다.

들여쓰기 문제는 거의 항상 세 가지 패턴입니다. 두 칸으로 중첩을 시도한 목록, 빈 줄 없이 이어진 코드 블록, 그리고 문단을 들여쓰려는 시도. 문서가 이상하게 렌더링될 때 이 순서대로 확인하면 열에 아홉은 바로 잡을 수 있습니다.

새 문서를 시작할 때는 목록의 들여쓰기 폭을 미리 정해 두세요. 대시에는 두 칸, 숫자에는 세 칸이라는 규칙을 팀이 합의하면 리뷰에서 들여쓰기 논쟁이 사라집니다. 위의 놀이터는 그 규칙이 실제로 어떻게 보이는지 보여 주는 가장 빠른 참고서입니다.

들여쓰기는 마크다운에서 유일하게 문맥을 읽어야 하는 문법입니다. 그래서 혼란스럽지만, 블록이라는 개념 한 번만 잡으면 모든 규칙이 하나로 정렬됩니다. 지금 내가 어떤 블록 안에 있는가. 이 질문 하나가 들여쓰기의 모든 경우를 설명합니다.