Quick Syntax

첫 번째 문단입니다.

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

빈 줄은 새 문단이고, 단순 개행은 soft break이며 CommonMark 출력에서는 line ending 또는 space로 처리될 수 있습니다. 같은 문단에서 꼭 줄을 바꾸려면 후행 공백 두 칸 또는 backslash hard break를 쓰되, trailing whitespace를 지우는 formatter가 있다면 눈에 보이는 backslash 방식을 선택합니다.

문법

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

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 이상

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

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

CommonMark는 soft break 출력에 line ending 또는 space를 허용한다

CommonMark는 soft break(단순 개행)를 HTML line ending 또는 space로 렌더링할 수 있도록 허용한다. renderer가 <br>을 넣는 hard break와는 다른 개념이며, 실제 화면 줄바꿈은 CSS와 화면 폭에도 영향을 받는다. 특히 중국어·한국어·일본어 같은 CJK 문자는 공백 없이 연결되는 특성이 있어, source에서 개행해도 render 결과에서 단어 사이 공백이 생기지 않는다. CJK 중심의 기술 문서에서는 이 차이가 문단 설계에 영향을 줄 수 있다.

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

선택 기준

주의할 점

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

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