Markdown 줄바꿈: 새 줄, 문단, 표 셀

Markdown 문단 안에서 새 줄을 시작하려면 첫 번째 줄 끝에 백슬래시를 넣고 Enter를 누르세요. 별도의 문단을 시작하려면 빈 줄을 하나 남깁니다. 두 방식은 서로 다른 문서 구조를 만들며, 나중에 README, 주소 또는 보고서를 Word로 내보낼 때 이 차이가 중요합니다.

문서 팀\
예시 거리 42번지\
오리건주 포틀랜드

주소는 하나의 문단을 유지하면서 세 줄로 표시됩니다. Markdown 미리보기에 붙여 넣어 아래 예제와 비교해 보세요.

필요한 줄바꿈 방식 선택하기

원하는 결과	Markdown 소스	일반적인 용도
같은 문단 이어 쓰기	일반 줄바꿈 한 번	긴 소스 줄 나누기
같은 문단 안에서 새 줄 시작하기	백슬래시 뒤에 Enter	주소와 짧은 시
새 문단 시작하기	빈 줄	글에서 서로 다른 생각 구분하기
표 셀 안에서 줄바꿈하기	HTML을 지원하는 경우 `<br>`	한 셀에 짧은 라벨 두 개 넣기

줄바꿈은 페이지 나누기를 만들지 않습니다. 내보낸 문서에서 다음 절을 새 페이지로 시작해야 한다면 별도의 Markdown 페이지 나누기 가이드를 참고하세요.

Enter를 눌러도 공백처럼 보이는 이유

다음 소스를 시험해 보세요.

초안이 준비되었습니다.
검토자는 오늘 문서를 열 수 있습니다.

이 사이트의 미리보기에서는 두 문장이 하나의 문단에 속하며 이어서 표시됩니다. 소스 파일의 줄바꿈은 여전히 소스를 읽는 데 도움이 되지만, 브라우저에 새 표시 줄을 시작하도록 강제하지 않습니다. 브라우저는 사용 가능한 너비에 따라 텍스트를 자동으로 줄바꿈할 수 있습니다.

이제 빈 줄을 넣어 보세요.

초안이 준비되었습니다.

검토자는 오늘 문서를 열 수 있습니다.

미리보기는 두 문단을 만듭니다. 두 번째 문장에서 새로운 생각을 시작할 때 이 방식을 사용하세요. 빈 줄을 여러 개 추가하는 것은 세로 간격을 늘리는 확실한 방법이 아닙니다. 문단 스타일은 렌더러나 문서 템플릿에서 결정합니다.

백슬래시 또는 줄 끝의 공백 두 개

CommonMark는 줄바꿈 문자 앞의 공백 두 개와 줄바꿈 문자 앞의 백슬래시를 문단 내부의 강제 줄바꿈 문법으로 정의합니다. CommonMark 강제 줄바꿈 예제에서 두 형식을 모두 확인할 수 있습니다.

백슬래시 방식은 파일을 검토할 때 표시가 눈에 보입니다.

문서 팀이 작성\
릴리스 관리자가 검토

다른 방법은 작성 뒤에 공백을 정확히 두 개 입력한 다음 Enter를 누르는 것입니다. 많은 편집기에서는 이 공백이 보이지 않으며, 줄 끝 공백 자동 정리 기능이 지울 수도 있습니다. 저장 후 줄바꿈이 사라지면 공백 설정을 확인하거나 백슬래시 방식을 사용하세요.

일반 본문에 \n이라는 두 문자를 입력하고 줄바꿈을 기대하지 마세요. 이것은 프로그래밍 문자열의 관례이며 Markdown 줄바꿈이 아닙니다. 문단 맨 끝에 백슬래시를 놓는 것도 피하세요. 강제 줄바꿈 뒤에는 같은 문단의 다음 줄 내용이 있어야 합니다.

GitHub 댓글과 README 파일은 다르게 동작합니다

GitHub의 줄바꿈 문서는 저장소의 .md 파일과 이슈, 풀 리퀘스트, 토론을 구분합니다. 이런 대화 화면에서는 일반 줄바꿈이 표시상의 줄바꿈으로 나타날 수 있지만, README에는 명시적인 강제 줄바꿈 문법이 필요합니다.

그래서 이슈에서 복사한 텍스트가 README에서는 다르게 보일 수 있습니다. 같은 웹사이트의 모든 화면이 동일한 서식 규칙을 사용한다고 가정하지 말고 대상 파일을 확인하세요.

이어지는 줄을 목록 항목 안에 유지하기

이어지는 줄을 항목 본문의 시작 위치에 맞춰 들여쓰기합니다.

- 릴리스 노트\
  마이그레이션 지침을 포함합니다.
- 설치 가이드

여기서 첫 번째 항목은 두 줄로 표시되고, 두 번째 항목은 별도로 유지됩니다. 첫 번째 항목 안에서 별도의 문단을 만들려면 빈 줄을 넣고 이어지는 내용의 들여쓰기를 유지하세요.

- 릴리스 노트

  마이그레이션 지침과 알려진 문제를 포함합니다.
- 설치 가이드

들여쓰기 가이드는 번호 목록, 중첩된 글머리 기호 목록, 항목 내부의 코드를 다룹니다.

Markdown 표 셀 안에 새 줄 추가하기

GFM 표의 한 행은 소스에서도 한 줄에 있어야 합니다. 내용 안에서 Enter를 누르면 행이 나뉠 수 있습니다. HTML 줄바꿈을 허용하는 렌더러에서는 다음 형식을 사용하세요.

| 문서 | 담당자 |
| --- | --- |
| 릴리스 노트 | 작성자<br>검토자 |

이 사이트의 미리보기는 이 예제를 지원합니다. HTML을 제거하는 대상 플랫폼에서는 줄바꿈이 사라지거나 태그가 그대로 보일 수 있으므로, 문서 전체에 적용하기 전에 해당 플랫폼을 확인하세요. 셀에 여러 문단이 필요하다면 표 밖에 목록을 두는 편이 유지 관리하기 쉬운 경우가 많습니다.

표 형식 데이터에는 Markdown 표 생성기를 사용하고, 정렬과 파이프 문자 이스케이프는 표 문법 가이드를 참고하세요.

내보낸 문서 확인하기

Markdown을 Word로 변환하는 도구를 사용하기 전에 일반 줄바꿈, 명시적인 강제 줄바꿈, 빈 줄을 하나씩 포함하는 짧은 샘플을 시험해 보세요. 미리보기에는 각각 이어지는 하나의 문단, 강제 줄바꿈, 서로 분리된 두 문단이 표시되어야 합니다.

다운로드한 DOCX를 열어 주소, 목록, 표를 확인하세요. 기본 줄바꿈 구조가 올바르더라도 페이지 너비와 Word의 문단 스타일에 따라 자동 줄바꿈 위치가 달라질 수 있습니다. 먼저 Markdown 구조를 수정하고, 특정 문서 템플릿에서 요구하는 경우 Word에서 최종 조판을 조정하세요.