CSS / Reference / white-space
white-space는 연속 공백과 원문의 줄바꿈을 보존할지, 너비에 맞춰 자동 줄바꿈을 허용할지 정합니다. 일반 문장은 normal, 입력한 줄바꿈과 공백을 유지하면서 자동으로 감싸려면 pre-wrap을 사용하는 것이 기본적인 선택입니다.
문법과 주요 값
.copy { white-space: normal; }
.log { white-space: pre-wrap; overflow-wrap: anywhere; }
| 값 또는 구분 | 동작과 선택 기준 |
|---|---|
normal |
공백·원문 줄바꿈 병합, 자동 줄바꿈 허용 |
nowrap |
공백 병합, 자동 줄바꿈 막음 |
pre |
공백·원문 줄바꿈 보존, 자동 줄바꿈 막음 |
pre-wrap |
공백·원문 줄바꿈 보존, 자동 줄바꿈 허용 |
pre-line |
공백 병합, 원문 줄바꿈 보존, 자동 줄바꿈 허용 |
값의 적용 범위와 문법은 MDN의 white-space 문서에서 확인할 수 있습니다.
실행 예제와 결과 비교
아래 전체 코드를 UTF-8 형식의 white-space-example.html 파일로 저장한 뒤 브라우저로 여세요. 예제용 CSS는 이 파일 안에만 넣고 사이트 전체 스타일시트에 그대로 붙여 넣지 않습니다.
<!doctype html>
<html lang="ko">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>white-space 비교 예제</title>
<style>
body { margin: 0; color: #20242b; background: #fff; font: 16px/1.7 "Malgun Gothic", sans-serif; }
#demo { padding: 24px; max-width: 820px; margin: auto; }
h1 { font-size: 22px; margin: 0 0 20px; }
.samples { display: flex; flex-wrap: wrap; gap: 24px; }
.label { margin: 0 0 8px; font-weight: 700; }
.target, .reference { width: 240px; padding: 12px; border: 1px solid #718096; }
.target { white-space: pre-wrap; }
.reference { white-space: normal; }
</style>
</head>
<body>
<main id="demo">
<h1>white-space 적용 비교</h1>
<section class="samples"><div class="a"><p class="label">pre-wrap</p><div class="target">첫째 둘째
셋째 줄에는 조금 더 긴 문장이 들어 있습니다.</div></div><div class="b"><p class="label">normal</p><div class="reference">첫째 둘째
셋째 줄에는 조금 더 긴 문장이 들어 있습니다.</div></div></section>
</main>
</body>
</html>
pre-wrap에서는 연속 공백과 원문의 줄바꿈이 남고, normal에서는 같은 텍스트가 일반적인 문장처럼 합쳐집니다. 두 경우 모두 너비에 따른 자동 줄바꿈은 가능합니다.
긴 한 단어의 처리까지 분리하기
자동 줄바꿈을 허용해도 긴 URL이나 공백 없는 식별자는 넘칠 수 있습니다. white-space는 공백 처리와 감싸기를 제어하며, 단어 내부의 비상 줄바꿈은 overflow-wrap이나 word-break의 역할입니다. nowrap이 있으면 비상 줄바꿈 설정만으로 감싸기가 생기지 않을 수 있습니다.
최신 단축 속성과 기존 키워드
현재 white-space는 white-space-collapse와 text-wrap-mode를 묶는 단축 속성으로 설명됩니다. 위의 전통적인 키워드는 널리 쓰이는 조합입니다. break-spaces는 보존한 공백의 줄바꿈과 끝 공백 처리에서 pre-wrap과 다르므로 공백 자체의 배치가 중요한 경우 별도로 확인하세요.
적용되지 않거나 예상과 다를 때
- HTML 편집 과정에서 원문의 공백과 줄바꿈이 실제로 남아 있는지 확인합니다.
- 상위 요소나 테마의 nowrap 규칙이 적용되는지 Computed에서 확인합니다.
관련 설정을 함께 조정할 때는 긴 단어의 비상 줄바꿈, word-break의 언어별 줄바꿈을 참고하세요.











