---
name: korean-ux-writing
description: "웹사이트나 앱의 한국어 화면 문구(버튼, 라벨, 안내, 오류, 알림, 빈 화면, 확인 창)를 쓰거나 고칠 때 쓴다. 화면 코드를 만들면서 문구를 넣을 때도 자동으로 따른다."
---

# 한국어 화면 문구 쓰기

## 말투

- 서비스 전체에서 한 가지 높임(해요체 또는 합니다체)만 쓴다. 이미 정해진 말투가 있으면 그것을 따른다.
- 시스템의 말이 아니라 사용자의 말로 쓴다. "요청 처리에 실패했습니다"가 아니라 "저장하지 못했어요".

## 버튼과 링크

- 누르면 일어나는 일을 동사로 쓴다: "저장하기", "보내기", "삭제". "확인", "제출", "OK"는 피한다.
- 같은 행동은 처음부터 끝까지 같은 낱말로 부른다. 버튼이 "게시"면 완료 알림도 "게시했어요".
- 되돌릴 수 없는 행동은 무엇이 사라지는지 버튼이나 확인 창에 적는다.

## 오류

- 무엇이 잘못됐는지와 어떻게 고치는지를 함께 쓴다: "비밀번호가 8자보다 짧아요. 8자 이상으로 적어 주세요."
- 사과로 시작하지 않는다. 사용자를 탓하지 않는다.
- 오류 코드는 필요할 때만, 문장 뒤에 괄호로 붙인다.

## 빈 화면과 불러오는 중

- 빈 화면은 기분이 아니라 다음 행동을 알려 준다: "아직 저장한 글이 없어요. 글 오른쪽 위 책갈피를 누르면 여기에 모여요."
- 오래 걸리는 작업은 무엇을 하고 있는지 알린다.

## 피할 것

- 개발자 말: 서버, 요청, 세션, null, 실패 코드
- 영어를 그대로 옮긴 말: "성공적으로 저장되었습니다" 대신 "저장했어요"
- 영어식 긴 줄표, 느낌표 남발, 과장

## 돌려줄 것

문구를 고칠 때는 화면, 원래 문구, 고친 문구, 까닭을 표로 주고, 이 서비스에서 쓸 용어 목록(쓸 말, 쓰지 않을 말)을 함께 정리한다.
