UX Writing
어떤 컴포넌트를 쓸지 토큰과 스펙이 정한다면, 그 안에 들어갈 말을 고르는 기준은 이 페이지가 정해요. 토스트 길이나 팝업 제목 문형처럼 컴포넌트 안에서만 통하는 규칙은 각 컴포넌트 문서에 있어요.
쓰기 기준
무엇을 말하고(원칙), 어떻게 쓰고(문장), 어떤 결로 말할지(톤)를 정해요. 개별 문구를 쓰기 전에 한 번 읽어 두는 층이에요.
원칙
원칙에는 번호와 이름을 붙였어요. 리뷰 자리에서 "3번을 어겼어요"처럼 근거로 부를 수 있게 하려는 거예요.
| 원칙 | ✓ 이렇게 | ✗ 이러지 않기 |
|---|---|---|
| 01결론이 먼저예요사용자가 알아야 할 결과를 첫 문장에 둬요. 원인과 배경은 그다음이에요. | PDF로 변환하지 못했어요. 암호가 걸린 문서는 변환할 수 없어요 | 문서에 암호가 설정되어 있어 변환 처리 과정에서 오류가 발생했습니다 |
| 02한 화면엔 한 목소리같은 화면에 함께 뜨는 문구는 어미를 맞춰요. 모달과 그 위에 겹치는 토스트도 한 화면이에요. | 문서를 저장했어요 / 공유 링크를 복사했어요 | 문서를 저장했어요 / 공유 링크가 클립보드에 복사되었습니다 |
| 03사용자를 탓하지 않아요문장의 주어를 사용자로 만들지 않아요. 무엇이 안 되는지만 말하고 판단은 붙이지 않아요. | 올릴 수 없는 형식이에요. docx · hwp · pdf만 올릴 수 있어요 | 잘못된 형식의 파일을 선택하셨습니다 |
| 04막다른 문구를 만들지 않아요문제만 알리고 끝내지 않아요. 사용자가 지금 할 수 있는 일을 한 가지는 남겨요. | 저장하지 못했어요. 연결을 확인하고 다시 시도해 주세요 | 저장 실패 |
| 05확인한 것만 말해요시스템이 확인하지 않은 상태를 사실처럼 쓰지 않아요. 정확성·완전성을 주장하는 표현이 대표적이에요. | AI가 요약했어요. 중요한 내용은 원문과 비교해 주세요 | 문서의 핵심을 정확하게 요약했어요 |
| 06길어지면 그릇을 바꿔요문구를 억지로 줄이는 대신 컴포넌트를 바꾸는 게 답일 때가 많아요. 어떤 그릇에 무엇이 들어가는지는 각 컴포넌트 문서가 정해요. | 변환 옵션 설명 3문단 → 팝업 대신 도움말 페이지로 분리 | 토스트 한 줄에 원인 · 해결 방법 · 문의처를 모두 넣기 |
문장
원칙이 '무엇을 말할까'라면 여기는 '어떻게 쓸까'예요. 아래 다섯 가지는 한국어 UI에서 가장 자주 나오는 실수라, 표기를 맞추기 전에 먼저 걸러요.
| 규칙 | ✓ 이렇게 | ✗ 이러지 않기 |
|---|---|---|
| 쉬운 단어로한자어·기술 용어 대신 일상어를 써요. | 문서를 열 수 없어요 | 문서 열람이 불가능합니다 |
| 존댓말은 어미까지만해요체로 이미 존대가 돼요. 어미에 존칭을 겹쳐 넣지 않아요. | 문서를 10개까지 만들 수 있어요 | 문서를 10개까지 만드실 수 있어요 |
| 긍정문 먼저같은 뜻이면 할 수 있는 쪽으로 써요. 금지형은 정말 금지일 때만 써요. | 이름은 한 달에 한 번만 바꿀 수 있어요 | 이름은 한 달에 한 번 넘게 바꿀 수 없어요 |
| 능동문 먼저이중 피동은 특히 피해요. 다만 피동이 뜻을 더 정확히 전할 땐 피동을 써요. | 변경 내용을 저장했어요 | 변경 내용이 저장되어졌어요 |
| 상태값은 붙여 쓰기화면에 찍히는 상태 이름은 붙이고, 문장 안에서 서술할 때는 띄어요. | 「편집중」 / 편집 중일 때는 내보낼 수 없어요 | 「편집 중」 / 편집중일 때는 내보낼 수 없어요 |
보이스와 톤
목소리는 하나, 사용자의 일을 방해하지 않는 동료의 말투예요. 다만 사용자가 놓인 상황에 따라 톤은 달라져요. 우리 제품은 사용자가 자기 일에 몰입한 편집 도구라서, 재치보다 예측 가능성이 먼저예요.
| 상황 | 톤 | 이렇게 | 이러지 않기 |
|---|---|---|---|
| 오류 · 데이터 손실 위험 | 원인 + 다음 행동 | 저장하지 못했어요. 연결을 확인해 주세요 | 문제가 발생했습니다 |
| 되돌릴 수 없는 동작 | 결과를 먼저 | 삭제하면 되돌릴 수 없어요 | 정말요? |
표기 규칙
해외 디자인 시스템의 문법 절은 대문자·축약형 규칙이 알맹이라 한국어에 그대로 옮겨지지 않아요. 이 절은 우리가 직접 정한 기준이에요.
문체
제품 UI와 문서 모두 해요체가 기본이에요. 법적·보안 고지처럼 격식이 필요한 자리만 합니다체를 써요.
| 자리 | 기준 | 예 |
|---|---|---|
| 안내 · 설명 | 해요체 서술 | 변경한 내용은 자동으로 저장돼요 |
| 완료 · 실패 알림 | 해요체 과거형 | 링크를 복사했어요 |
| 사용자에게 요청 | ~해 주세요 | 8자 이상 입력해 주세요 |
| 절차 안내 | ~하세요 | 저장한 뒤 다시 시도하세요 |
| 법적 · 보안 고지 | 합니다체 | 이 작업은 감사 기록에 남습니다 |
| 문서 사이트 산문 | 해요체 | (이 페이지) |
호칭은 쓰지 않아요. "고객님"·"회원님" 없이 주어를 생략하고, 서비스를 "저희"로 부르지 않아요.
문장부호
| 기호 | 용도 | 예 |
|---|---|---|
· | 병렬 나열 (쉼표보다 먼저) | docx · hwp · pdf |
— | 문장 뒤 부연 (앞뒤 공백) | 삭제했어요 — 30일 안에는 되돌릴 수 있어요 |
– | 숫자 범위 전용 | 1–2줄, 02:00–04:00 |
「」 | 화면에 찍히는 UI 레이블 인용 | 「저장 안 함」을 누르면 변경 내용이 사라져요 |
" " | 사용자 발화 · 개념 인용 | "이 문서 요약해 줘" |
예) | 예시 도입 | 예) 2026. 8. 30. |
! | 쓰지 않아요 | — |
✓ DO
- 명사구 목록 항목은 마침표 없이 끝내기
- 화면에 나가는 완결 문장은 마침표로 끝내기 (단, 표·목록 안의 짧은 예시는 표기라서 생략해요)
- 파일명·토큰명은 코드 표기로 감싸기
✗ DON'T
- 링크 텍스트나 문장 전체를 통째로 굵게 처리
- 파일명·토큰명을 따옴표로 감싸기
- 느낌표로 감정 얹기
숫자 · 날짜 · 단위
| 항목 | 기준 | 예 |
|---|---|---|
| 단위 | 숫자에 붙여 쓰기 | 150ms, 60%, 12.4MB |
| 치수 | 곱셈기호 × | 21×21px |
| 범위 | en dash | 2–5개, 360–767px |
| 천 단위 | 쉼표 | 3,000ms |
| 개수 | 아라비아 숫자 + 개 · 종 · 단계 | 문서 12개 |
| 날짜 (본문) | ~월 ~일 | 8월 30일에 갱신돼요 |
| 날짜 (목록 · 메타데이터) | YYYY. M. D. | 2026. 8. 30. |
| 시각 | 24시간 HH:MM | 02:00–04:00 |
| 용량 | 소수 첫째 자리까지 | 12.4MB / 1.2GB |
영문
✓ DO
- PDS 고유 이름(컴포넌트 · variant · 상태)은 영문 그대로: Primary, Fill, Selected
- 일반 UI 개념은 한글로: 배경, 버튼, 상태, 레이블
- 레이블 없는 아이콘 버튼에는 화면 문구와 같은 말로 접근 이름 지정
✗ DON'T
- 같은 대상을 한 화면에서 '토스트'와 'Toast'로 번갈아 쓰기
- 한 문장 안에서 영문 조사 처리를 섞기 (붙여 쓰든 띄어 쓰든 문서 안에서 통일)
상황별 문구
실제 화면에서 자주 마주치는 자리들이에요. 위의 기준을 이 자리에 적용한 결과라고 보면 돼요.
상태 메시지
화면을 만들 때 성공 화면만 만들고 끝내지 않아요. 목록·데이터 화면에는 빈 상태와 에러 상태 문구가 함께 있어야 해요.
에러
무엇이 일어났는지 → 왜 → 다음에 무엇을 할지 순서로 써요. 세 번째 조각이 없으면 원칙 04를 어긴 거예요. 원인을 구체적으로 알려 주는 건 Input Field 문서의 규칙이기도 해요.
| 상황 | 문구 |
|---|---|
| 저장 실패 (오프라인) | 저장하지 못했어요. 연결이 끊겼어요 — 연결되면 자동으로 다시 저장해요. |
| 동시 편집 충돌 | 다른 사람이 먼저 저장했어요. 내 변경 내용은 사본으로 저장할 수 있어요. |
| 변환 실패 (암호 문서) | PDF로 변환하지 못했어요. 암호가 걸린 문서예요 — 암호를 풀고 다시 시도해 주세요. |
| 용량 초과 | 파일이 너무 커요. 한 번에 100MB까지 올릴 수 있어요 — 나눠서 올려 주세요. |
| AI 요약 실패 | 요약을 만들지 못했어요. 문서는 그대로예요 — 잠시 뒤 다시 시도해 주세요. |
빈 상태와 로딩
지금 왜 비어 있는지 → 무엇을 하면 채워지는지. 첫 사용과 검색 결과 없음은 다른 문구예요. 첫 사용은 시작을 권하고, 검색 결과 없음은 조건을 바꾸도록 안내해요.
✓ DO
- 첫 사용: 아직 문서가 없어요. 새 문서를 만들어 시작해 보세요
- 검색 결과 없음: '분기 보고서'와 일치하는 문서가 없어요. 다른 검색어로 찾아보세요
- 권한 없음: 이 폴더를 볼 권한이 없어요. 소유자에게 요청할 수 있어요
✗ DON'T
- 빈 화면에 문구 없이 일러스트만 두기
- 검색 결과 없음에 첫 사용 문구를 그대로 쓰기
아직 채워지는 중이라면 기다림이 1초를 넘을 때 무엇을 하고 있는지 밝혀요. 「로딩중」보다 「문서를 읽고 있어요」가 같은 시간을 짧게 느끼게 해요.
AI 기능
보라색이 AI 전용 신호색인 것처럼, AI 문구도 AI 기능의 진입·실행·결과에만 써요. 사용자가 결과를 검토할 여지를 남기는 게 이 영역의 기본이에요.
✓ DO
- 결과에 검토 여지 남기기: AI가 요약했어요. 중요한 내용은 원문과 비교해 주세요
- 대기 중 무엇을 하는지 밝히기: 문서를 읽고 있어요
- 실패 시 원본이 무사함을 알리기: 요약을 만들지 못했어요. 문서는 그대로예요
- 사용자가 고르게 두기: 이 문단으로 바꿀까요?
✗ DON'T
- 정확성 · 완전성을 단정하기: 정확하게 요약했어요
- AI를 사람처럼 말하게 하기: 제가 도와드릴게요
- AI가 한 일을 사용자가 한 것처럼 적기: 문서를 정리하셨어요
- AI가 아닌 기능에 AI 어휘 · 보라색 쓰기
용어 사전
같은 개념을 화면마다 다르게 부르면 학습 비용이 바로 생겨요. 왼쪽 말만 써요. 이 표는 i18n 키를 지을 때도 그대로 기준이 돼요.
| 쓰는 말 | 쓰지 않는 말 | 구분 기준 |
|---|---|---|
| 문서 | 파일 (사용자 콘텐츠를 가리킬 때) | 사람이 만들고 편집하는 것 |
| 파일 | 도큐먼트 | 업로드 · 다운로드 대상 |
| 저장 | 세이브, 적용 | 문서 상태를 남기는 동작 |
| 공유 | 퍼블리싱 | 링크로 접근 권한을 여는 것 |
| 초대 | 사용자 추가 | 사람을 지정해 권한을 주는 것 |
| 내보내기 | 익스포트 | 다른 형식으로 꺼내는 것 |
| 변환 | 컨버팅 | 형식이 바뀌는 것. 예) PDF로 변환 |
| 휴지통 | 삭제된 항목 | 되돌릴 수 있는 삭제 보관함 |
| 요금제 | 플랜, 상품 | 구독 등급 |
| 사용자 | 멤버, 유저 | B2B 관리자 화면의 구성원 |
| 용량 | 저장공간, 스토리지 | 쓰고 남은 양 |
| 버전 기록 | 히스토리 | 이전 상태 목록 |
| AI 요약 | 자동 요약, 스마트 요약 | AI 기능 이름 |