숏컷 코드

첫 번째 문단입니다.

두 번째 문단입니다.
같은 문단에서 줄만 바꾸고 싶다면 끝에 공백 두 칸을 넣거나\
역슬래시를 씁니다.

문법

소스의 단순 개행은 문단을 나누지 않는다 — 빈 줄이 기준이다

Markdown의 핵심 설계 결정 중 하나는 소스에서 줄을 바꿔도 그것이 곧바로 줄바꿈으로 렌더링되지 않는다는 점이다. CommonMark 기준으로 문단은 하나 이상의 빈 줄로 분리된다. 소스에서 두 문장을 연속으로 쓰면 렌더러는 이것을 하나의 문단으로 이어서 출력한다. 이 동작은 소스 가독성과 출력 가독성을 분리해 관리하려는 의도이지만, 처음 접하는 사람에게는 혼란의 원인이 된다.

운영체제는 자원을 관리합니다.
프로세스는 실행 중인 프로그램입니다.
<!-- 위 두 줄은 렌더링 시 한 문단으로 합쳐짐 -->

스레드는 그 안의 실행 흐름입니다.
<!-- 빈 줄이 있어야 새 문단으로 분리됨 -->

hard break에는 후행 공백 방식과 역슬래시 방식이 있으며 각각 함정이 다르다

같은 문단 안에서 줄을 강제로 바꾸는 hard break에는 두 가지 방법이 있다. 첫째는 줄 끝에 공백 두 칸( )을 추가하는 방식이고, 둘째는 CommonMark에서 도입된 역슬래시(\) 방식이다. 후행 공백 방식은 전통적이지만 많은 편집기와 git pre-commit hook이 trailing whitespace를 자동 삭제해 hard break가 사라지는 버그가 생긴다. 역슬래시 방식은 눈에 보이기 때문에 더 명시적이고 편집기 자동 삭제의 영향을 받지 않는다.

시스템 구성 요소:
CPU, 메모리, 저장소 (후행 공백: 눈에 보이지 않아 실수 발생 가능)

시스템 구성 요소:\
CPU, 메모리, 저장소 (역슬래시: 명시적이고 편집기 영향 없음)

hard break 대신 문단 분리를 선택하는 것이 대부분 더 나은 설계다

hard break는 시, 주소, 구성 요소 나열처럼 줄 구분이 의미를 가지는 특수한 경우에 적합하다. 일반 기술 문서에서는 "이 문장과 다음 문장이 다른 생각이라면" 빈 줄로 문단을 분리하는 것이 더 명확하다. hard break는 같은 문단 안 임시 줄바꿈이기 때문에, 정보 단위가 다르다면 문단 분리를 먼저 고려해야 한다.

<!-- hard break가 적합한 경우: 구성요소 목록 -->
설치 요구사항:\
Node.js 18 이상\
npm 9 이상\
Git 2.30 이상

<!-- 문단 분리가 더 나은 경우 -->
설치 전에 요구 사항을 확인합니다.

환경이 준비되면 저장소를 클론합니다.

렌더러마다 soft break 처리 방식이 달라 이식성에 영향을 준다

CommonMark는 soft break(단순 개행)를 공백 한 칸으로 변환하도록 규정하지만, 일부 렌더러는 <br>을 삽입하거나 아무것도 하지 않기도 한다. 특히 중국어·한국어·일본어 같은 CJK 문자는 공백 없이 연결되는 특성이 있어, 소스에서 개행해도 렌더링 결과에서 단어 사이 공백이 생기지 않는다. CJK 중심의 기술 문서에서는 이 차이가 문단 설계에 영향을 줄 수 있다.

실무에서는 "줄만 바꿨는데 왜 한 문단이지?"와 "문단을 나눠야 하는데 hard break로 버텼다"가 가장 흔한 실수다. 문장 덩어리가 달라지면 빈 줄, 같은 덩어리 안 시각적 줄바꿈이면 hard break라는 기준을 먼저 고정하는 편이 좋다.

선택 기준

주의할 점

설치합니다.
재시작합니다.

이 두 줄은 소스에서는 나뉘어 보여도 대부분의 렌더러에서는 한 문단으로 이어집니다. 문단 분리를 기대했다면 빈 줄이 빠진 상태입니다.