이 글은 누구를 위한 것인가
- "이럴 때는 이렇게" 형태의 가이드 문서를 만드는 팀
- 문서는 많은데 사용자가 자기에게 맞는 걸 못 찾는 상황
- 검색으로 들어온 사용자의 이탈률이 유독 높은 경우
들어가며
가이드 문서에는 두 종류가 있다.
[제품 중심] [상태 중심]
"스포츠 마사지란" "운동하고 나서 뭉쳤을 때"
"아로마 테라피 소개" "스트레스로 잠이 안 올 때"
"경락의 원리" "목이 안 돌아갈 때"
→ 이미 아는 사람이 찾음 → 모르는 사람이 찾음
검색으로 유입되는 사용자는 거의 전부 오른쪽 언어를 쓴다. 자기 상태는 알지만 해결책의 이름은 모른다. 그런데 대부분의 가이드는 왼쪽으로 쓰여 있다.
이 글은 오른쪽 형태의 문서를 어떻게 설계하는지 다룬다.
1. 진입 지점을 여러 개 만든다
같은 상태를 사람마다 다르게 표현한다.
[하나의 상태, 여러 표현]
"목이 뻐근하다"
"어깨가 뭉쳤다"
"고개 돌리면 아프다"
"거북목인 것 같다"
"종일 모니터 봤더니"
문서 하나에 이 표현들이 모두 담겨 있어야 어느 쪽으로 검색해도 도달한다. 다만 키워드를 나열하는 방식은 안 된다.
❌ 키워드 나열
"목 뻐근, 어깨 뭉침, 거북목, 승모근, 일자목…"
✅ 도입부에서 상황을 서술
"하루 종일 모니터를 보고 나면 목뒤가 뻣뻣해지고,
고개를 옆으로 돌릴 때 한쪽만 잘 안 돌아가는 경우가 있습니다.
어깨 위쪽이 딱딱하게 뭉친 느낌이 함께 오기도 합니다."
서술형이 검색에도 유리하고 읽는 사람에게도 "내 얘기다"라는 확인을 준다. 나열은 둘 다 놓친다.
문서 상단에 **"이런 경우에 해당합니다 / 해당하지 않습니다"**를 두는 것도 효과적이다.
이런 상태라면 이 문서가 맞습니다
· 오래 앉아 있은 뒤 뻐근함이 온다
· 며칠 지나면 나아지는 편이다
이 문서로는 부족합니다
· 팔 저림이나 감각 이상이 함께 온다
· 특정 동작에서 날카로운 통증이 있다
→ 전문가 상담이 먼저입니다
"해당하지 않는 경우"를 명시하는 것이 신뢰를 만든다. 모든 사람을 붙잡으려는 문서보다, 아닌 사람을 돌려보내는 문서가 남는 사람에게 더 신뢰받는다.
2. 정보 향기 — 다음에 뭐가 나올지 보이게
사용자는 문서를 처음부터 읽지 않는다. 훑으면서 자기에게 맞는 지점을 찾는다.
Nielsen Norman Group이 정리한 정보 향기(information scent) 개념이 여기 그대로 적용된다. 각 소제목이 "이 아래에 무엇이 있는지"를 정확히 알려줘야 사용자가 훑기를 멈추고 읽기 시작한다.
❌ 향기가 약한 소제목
"알아두면 좋은 점"
"여러 가지 방법"
"참고 사항"
✅ 향기가 강한 소제목
"앉아서 1분 안에 해볼 수 있는 것"
"며칠 지나도 그대로일 때"
"어떤 방식이 나에게 맞는지 고르는 기준"
같은 조사에서 웹 문서는 읽히지 않고 훑어진다는 점도 확인된다. 이건 문서를 짧게 쓰라는 뜻이 아니라 훑는 사람이 필요한 지점에 착지할 수 있게 구조를 만들라는 뜻이다.
[훑기를 돕는 장치]
· 소제목이 구체적일 것 (위 예시)
· 문단 첫 문장에 결론
· 목록·표로 대비 구조 시각화
· 굵게 표시는 문단당 1회 — 남발하면 아무것도 안 보임
굵게 표시 남발이 실제로 흔한 실수다. 한 문단에 세 군데를 강조하면 강조가 사라진다.
3. 답이 아니라 판단 기준을 준다
가이드 문서의 가장 흔한 실패는 하나의 정답을 제시하는 것이다.
❌ "목·어깨 결림에는 경락 마사지가 좋습니다."
→ 사람마다 원인이 다름
→ 반박당하기 쉬움
→ 다른 선택지를 찾던 사용자는 이탈
✅ 선택 기준을 제시
강한 압을 선호하고 뭉친 부위가 명확하다면 → A 계열
압에 민감하거나 처음이라면 → B 계열
전신이 전반적으로 무겁다면 → C 계열
특정 동작에서만 아프다면 → 마사지 이전에 진료
"당신이 어느 쪽이면 무엇"의 형태가 훨씬 오래 유효하다. 정답을 제시한 문서는 예외가 나올 때마다 틀린 문서가 되지만, 기준을 제시한 문서는 예외를 흡수한다.
증상 축으로 정리된 가이드가 어떤 모양인지는 실제 문서를 보면 파악이 빠르다. 풀림의 목·어깨 가이드는 "어떤 마사지가 좋을까"를 제목으로 걸고 유형별 차이를 나열하는 구조인데, 제목에서 이미 "고민 중인 상태"를 전제하고 있다는 점이 상태 중심 설계의 특징이다. 제품 이름을 제목에 걸었다면 이 사용자는 도달하지 못한다.
4. 단정을 피하되 모호해지지 않기
건강·신체와 관련된 내용은 표현 수위 조절이 필요하다. 그렇다고 전부 "~일 수 있습니다"로 흐리면 아무 도움이 안 된다.
[구분]
단정해도 되는 것
· 서비스 절차, 소요 시간, 준비물
· 일반적으로 알려진 사실
· "이런 경우에는 전문가 상담" 같은 안전 안내
단정하면 안 되는 것
· 효과의 크기 ("반드시 좋아집니다")
· 원인 진단 ("당신의 통증은 OO 때문입니다")
· 치료적 표현
❌ "이 방법으로 통증이 사라집니다"
❌ "효과가 있을 수도 있고 없을 수도 있습니다" ← 정보 없음
✅ "일시적으로 뻐근함이 줄었다고 느끼는 경우가 많습니다.
다만 원인이 자세 습관이라면 그 자체를 바꾸지 않는 한
다시 돌아오는 편입니다."
세 번째가 정보량이 가장 많다. 한계를 함께 말하는 것이 오히려 구체적인 정보를 줄 수 있게 만든다.
의료적 판단이 필요한 신호는 별도 블록으로 분리한다. 본문에 섞으면 훑는 사람이 놓친다.
5. 접근성 — 구조가 곧 접근성이다
가이드 문서는 텍스트 중심이라 접근성 이슈가 적어 보이지만, 실제로는 구조 문제가 그대로 접근성 문제가 된다.
[체크리스트]
□ 제목 레벨을 건너뛰지 않기 (h2 다음에 h4 금지)
□ 소제목이 내용을 설명할 것 — WCAG 2.4.6
□ 목록은 <ul>/<ol> 로, 줄바꿈 + 하이픈으로 흉내내지 않기
□ 표에 <th> 와 scope 지정
□ 링크 텍스트만으로 목적지를 알 수 있을 것 ("여기" 금지)
□ 색만으로 구분하지 않기 (중요 표시에 아이콘·굵기 병행)
WCAG의 제목과 레이블 기준은 스크린 리더 사용자를 위한 것이지만, 소제목만 훑는 일반 사용자에게도 정확히 같은 이득을 준다. 같은 맥락에서 링크의 목적을 문맥에서 알 수 있어야 한다는 기준도, 훑는 사람이 링크만 보고 다음 행동을 정하는 상황과 정확히 겹친다. 3절에서 말한 정보 향기와 같은 요구사항이 접근성 기준으로도 존재하는 셈이다.
[긴 문서라면]
· 문서 상단에 목차 (앵커 링크)
· 각 섹션에서 목차로 돌아가는 링크는 불필요 — 브라우저 뒤로가기로 충분
· 스크롤 위치 복원 처리
6. 문서의 끝 — 다음 행동으로
가이드를 읽고 나면 사용자는 "그래서 뭘 하지"에 도달한다. 여기서 문서가 끊기면 이탈한다.
[문서 끝에 둘 것]
1. 요약 — 판단 기준 재정리 (3~5줄)
2. 다음 단계 — 구체적인 행동 하나
3. 관련 문서 — 인접 상태로 가는 경로
4. 아닌 경우의 경로 — 상담·진료 안내
❌ 문서 끝에 갑자기 "지금 예약하기" 버튼만
→ 읽던 흐름과 단절, 광고로 인식됨
✅ "이 유형이 맞는 것 같다면 근처에서 찾아볼 수 있습니다"
+ 지역/유형으로 좁혀진 목록으로 이동
전환 유도를 넣더라도 문서의 논리를 이어받아야 한다. 앞에서 "A 계열이 맞는 경우"를 설명했다면, 링크도 A 계열로 필터된 목록으로 가야 한다. 전체 목록으로 보내면 사용자는 처음부터 다시 골라야 한다.
[관련 문서 링크 고르는 기준]
✓ 인접 상태 "목·어깨" → "허리", "종일 서 있는 경우"
✓ 심화 같은 상태의 더 자세한 문서
✗ 무작위 최신글 문맥과 무관하면 클릭되지 않음
7. 측정
· 스크롤 깊이 분포 어디서 멈추는가
· 소제목별 체류 특정 섹션에서만 이탈하면 그 부분 문제
· 문서 → 다음 행동 전환율
· 검색 유입 키워드 문서가 실제로 어떤 표현으로 발견되는가
마지막 항목이 1절의 진입 지점 설계를 검증한다. 예상하지 못한 표현으로 유입되고 있다면, 그 표현을 도입부 서술에 반영하면 된다.
[개선 우선순위]
스크롤 20% 이내 이탈이 많다 → 도입부가 "내 얘기"로 안 읽힘
중간 섹션에서 이탈 → 그 섹션이 답을 안 줌
끝까지 읽고 이탈 → 다음 행동이 없거나 안 맞음
8. 정리
1. 제품 이름이 아니라 사용자 상태를 제목과 도입부에
2. 표현 다양성은 나열이 아니라 서술로 흡수
3. "해당하지 않는 경우"를 명시한다
4. 소제목은 아래 내용을 정확히 예고할 것
5. 정답이 아니라 판단 기준을 제시
6. 효과는 한계와 함께 말할 때 오히려 구체적이 된다
7. 접근성 구조가 곧 훑기 가능한 구조
8. 마무리 링크는 문서의 논리를 이어받은 곳으로
가장 효과가 큰 건 5번이다. 정답 하나를 제시한 문서는 자기와 다른 경우를 만난 사용자를 전부 잃지만, 기준을 제시한 문서는 그 사용자에게도 쓸모가 남는다.