콘텐츠로 건너뛰기
Help centers and docs

헬프 센터 아티클 작성법 (템플릿 포함)

고객이 끝까지 읽는 헬프 센터 아티클 작성법: 아티클당 질문 하나, 답변 우선 배치, 정확한 라벨 사용, 복사해서 쓰는 템플릿, 그리고 비포&애프터 수정 사례를 소개합니다.

Roozbeh Firoozmand읽는 시간 11분
빈 템플릿 옆 작은 타자기에서 타이핑하는 작가와, 그 페이지가 동료가 기기를 수리할 때 참고하는 간단한 단계 카드로 변하는 점토 일러스트

2026년 11월 3일 업데이트

헬프 센터 아티클을 작성할 때는 아티클 하나당 고객의 질문 하나에만 답하세요. 고객이 검색하는 단어를 제목으로 사용하고, 첫 두 문장에 답변을 담으세요. 그 후 번호를 매겨 단계를 설명하되, UI 라벨은 굵게 표시하고 핵심 단계마다 스크린샷을 하나씩 넣으세요. 마지막으로 사전 준비 사항, 예상 결과, 자주 발생하는 문제 해결 방법, 다음 단계로 이어지는 링크를 추가합니다. 작성을 마친 후에는 해당 내용을 모르는 사람이 직접 따라 해보게 하세요.

아래에서 복사해서 쓰는 템플릿, 비포&애프터 수정 사례, 제목 및 스크린샷 규칙, AI 어시스턴트를 위한 글쓰기, 유지 관리 방법, 그리고 아티클의 효과를 측정하는 방법을 알아보세요.

좋은 헬프 센터 아티클이란?

좋은 헬프 아티클은 독자가 문의를 남기지 않고도 하나의 작업을 완수하게 만듭니다. 그 외의 모든 요소는 이 목적을 위해 존재합니다:

어떤 유형의 헬프 아티클이 필요한가요?

대부분의 헬프 센터에는 네 가지 유형이 필요합니다. 이들을 섞어서 작성하면 아티클이 길어지고 사용하기 어려워집니다.

  • **방법(How-to)**은 "어떻게 하나요?"에 답합니다. 제목: "워크스페이스에 팀원 초대하기"와 같이 동사와 목적어로 구성. 구조: 답변, 사전 준비 사항, 번호가 매겨진 단계, 결과, 해결 방법.
  • **문제 해결(Troubleshooting)**은 "왜 작동하지 않나요?"에 답합니다. 제목: "초대 이메일이 도착하지 않음"과 같이 독자가 느끼는 증상으로 구성. 구조: 가장 가능성 높은 원인 우선 배치, 순서대로 확인, 고객 지원팀에 문의할 시점.
  • **개념(Concept)**은 "무엇인가요?" 또는 "해야 하나요?"에 답합니다. 제목: "역할과 권한이란 무엇인가요?". 구조: 정의, 작동 방식, 사용 시점, 다음 단계.
  • **참조(Reference)**는 "모든 ~는 무엇인가요?"에 답합니다. 제목: "워크스페이스 플랜 제한". 구조: 한 줄의 맥락이 포함된 표.

FAQ 페이지는 답변을 숨겨두는 곳이 아니라, 이러한 아티클로 연결되는 인덱스 역할을 해야 합니다.

헬프 센터 아티클 템플릿 (복사 및 붙여넣기)

필요한 아티클 유형의 템플릿을 복사하여 괄호 안의 내용을 수정하세요. 지식 베이스의 모든 아티클에 적용할 수 있습니다. 세 가지 템플릿과 게시 전 체크리스트 모두 다운로드하기 (일반 텍스트로 열림).

방법(How-to) 아티클 템플릿

[동사] [대상]

[한두 문장: 이 기능이 무엇을 하는지, 결과는 무엇인지 설명합니다. 이 문단만 읽어도 무엇을 해야 할지 알아야 합니다.]

시작하기 전에

  • 필요 사항: [플랜, 역할 또는 권한]
  • 준비물: [파일, 계정, 정보]

단계

  1. **[정확한 메뉴 또는 페이지 이름]**을 엽니다.
  2. **[정확한 버튼 라벨]**을 클릭합니다. [스크린샷: 클릭 직전 화면, 버튼 표시]
  3. [내용]을 입력하거나 선택한 후 **[버튼]**을 클릭합니다.
  4. [마지막 행동]. 다음이 표시됩니다: [작업이 완료되었음을 알리는 내용]

작동하지 않는 경우

  • [독자가 느끼는 증상]: [원인]. [해결 방법.]
  • [증상]: [해결 방법.]

관련 아티클: [사람들이 주로 하는 다음 작업] · [필요할 수 있는 개념]

마지막 업데이트: [날짜] · 담당자: [이름 또는 팀]

문제 해결(Troubleshooting) 아티클 템플릿

[독자가 느끼는 증상]

[한 문장: 가장 흔한 원인과 해결 방법.]

먼저 확인하세요

  1. [가장 빠른 확인 방법]. [해당될 경우 조치 사항.]
  2. [다음 확인 방법]. [해결 방법.]
  3. [다음 확인 방법]. [해결 방법.]

여전히 작동하지 않나요? [지원팀에 보낼 정보: 스크린샷, 계정 이메일, 발생 시점.] [문의 링크]

마지막 업데이트: [날짜] · 담당자: [이름 또는 팀]

사람들이 건너뛰는 부분의 용도:

섹션 용도 흔한 실수
도입부 답변 많은 독자가 여기서 멈춤; AI 어시스턴트가 인용함 환영 인사 ("이 아티클에서는…")
시작하기 전에 권한 부족으로 4단계에서 실패하는 것을 방지 "누구나 아는 내용"이라며 생략
다음이 표시됩니다 작업 완료 여부를 알려줌 마지막 클릭으로 끝냄
작동하지 않는 경우 후속 문의를 방지함 해결책 없는 일반적인 "지원팀 문의"
마지막 업데이트, 담당자 최신 상태임을 보여주고 책임 소재를 명확히 함 담당자가 없어 업데이트되지 않음

다운로드 파일에는 개념 아티클 템플릿("X란 무엇인가?")이 포함되어 있습니다. 참조 아티클의 경우, 한 줄의 맥락이 포함된 표를 사용하세요.

헬프 센터 아티클을 단계별로 작성하는 방법은?

  1. 실제 데이터에서 질문을 선택하세요

    문의 태그, 헬프 센터의 검색 결과 없음, 영업 및 고객 성공 팀이 통화 중 듣는 질문에서 시작하세요. 고객이 질문한 그대로 적으세요. 그 문장이 작업 제목이 됩니다. 커버리지가 중요합니다. 가트너(Gartner)의 5,728명 고객 대상 설문조사에 따르면, 셀프 서비스 실패의 가장 흔한 이유는 고객이 자신의 문제와 관련된 콘텐츠를 찾지 못했기 때문(43%)이었습니다 (Gartner, 2024; 고객 셀프 서비스 통계에서 자세히 확인 가능).

  2. 직접 작업을 수행하며 메모하세요

    독자의 역할을 맡아 제품 내에서 직접 수행하며 모든 클릭, 정확한 라벨, 나타나는 화면을 기록하세요. 작업 과정을 화면 녹화하세요. 스크린샷 프레임이나 영상으로 활용할 수 있습니다. 화면 녹화를 문서로 바꾸는 방법을 확인하세요.

  3. 답변을 먼저 작성하세요

    그 자체로 충분한 두 문장: 어디로 가야 하는지, 무엇을 해야 하는지, 어떤 결과가 나오는지. "팀원을 어떻게 초대하나요?"의 경우: "설정 › 멤버로 이동하여 초대를 클릭하세요. 관리자 역할이 필요합니다."

  4. 단계를 작성하세요

    동사로 시작하는 한 단계당 하나의 행동. 정확한 라벨은 굵게 표시하세요. 화면이 바뀌는 단계 뒤에는 결과를 추가하세요. 주의 사항은 해당 단계 위의 콜아웃에 넣으세요. 플랫폼 차이가 있다면 "Windows의 경우:"와 같이 짧게 적거나 탭을 사용하세요. 두 번째 아티클을 만들지 마세요. 12단계가 넘어가면 아티클을 나누세요.

  5. 길을 잃기 쉬운 곳에 스크린샷을 추가하세요

    모든 단계에 필요한 것은 아닙니다. 컨트롤을 찾기 어렵거나, 양식에 필드가 많거나, 완료 상태를 보여줘야 할 때 추가하세요. 클릭 직전 화면을 보여주고, 중요한 영역을 자르고, 대상을 표시하세요.

  6. 가장자리를 다듬으세요

    상단에는 사전 준비 사항을, 하단에는 이 작업과 관련해 문의가 자주 들어오는 두세 가지 문제 해결 방법을 넣으세요.

  7. 다른 사람과 테스트하세요

    해당 작업을 해본 적 없는 동료에게 보여주세요. 망설이는 부분을 지켜보세요. 망설임은 곧 누락된 단계, 잘못된 라벨, 혹은 부족한 스크린샷을 의미합니다.

  8. 게시하고 링크를 걸고 날짜를 기록하세요

    올바른 섹션에 배치하고(구조는 AI로 지식 베이스를 구축하는 방법 참조), 관련 아티클 및 제품 내에서 사람들이 막히는 화면에서 링크를 걸고, 날짜와 담당자를 추가하세요.

비포&애프터 수정 사례는 어떤 모습인가요?

가상의 프로젝트 도구(Clevera 아님)에 대한 일반적인 초안과, 템플릿을 사용하여 다시 작성한 동일한 아티클을 보여드립니다.

수정 전

팀 관리

이 글에서는 플랫폼 내 팀 관리에 대해 알아야 할 모든 것을 다룹니다. 팀 관리는 협업의 중요한 부분입니다! 새 멤버를 추가하려면 설정 영역으로 이동하여 멤버 섹션을 포함한 다양한 옵션을 확인하세요. 거기서 초대 기능을 사용하여 동료의 정보를 입력하고 초대장을 보낼 수 있습니다. 특정 사용자만 이 작업을 수행할 수 있다는 점을 유의하세요. 초대를 받으면 이메일이 발송됩니다.

변경 후

워크스페이스에 팀원 초대하기

설정 › 멤버로 이동하여 초대를 클릭하고 이메일 주소를 입력하세요. 관리자 역할이 필요합니다.

  1. 설정 › 멤버를 엽니다.
  2. 초대를 클릭합니다.
  3. 이메일 주소를 입력하고 역할을 선택합니다: 멤버 또는 관리자.
  4. 초대장 보내기를 클릭합니다. 상대방이 수락할 때까지 목록에 대기 중으로 표시됩니다.

작동하지 않는 경우

  • 초대 버튼이 비활성화된 경우: 관리자 역할이 없습니다. 관리자에게 초대를 요청하거나 역할을 변경해 달라고 하세요.
  • 이메일이 도착하지 않은 경우: 스팸 메일함을 확인하게 한 뒤, 이름 옆의 재전송을 클릭하세요.

관련 항목: 팀원의 역할 변경 · 팀원 제거

변경 사항:

변경 전 변경 후 이유
"팀 관리" "워크스페이스에 팀원 초대하기" 제목은 사용자가 검색하는 작업이어야 함
두 문장의 서론 첫 줄에 바로 답 제시 독자와 AI 어시스턴트는 페이지 상단을 참조함
"이메일이 발송됩니다" 대기 중 상태 및 이메일 미수신 시 대처법 후속 문의를 방지함

사람들이 찾는 제목을 작성하는 방법은?

제목은 고객의 언어로 작업이나 질문 형태로 작성하고, 중요한 단어를 앞에 배치하세요. 검색 결과에서 잘리지 않도록 약 60자 이내로 유지하세요.

약함 더 나음 이유
멤버 워크스페이스에 팀원 초대하기 기능 이름이 아닌 작업명
결제 FAQ 결제 카드 변경하기 아티클 하나당 질문 하나
내보내기 문제 해결 내보내기가 99%에서 멈춤 독자의 언어로 증상 표현
보고 기능 활용 방법 주간 보고서 만들기 군더더기 없는 평이한 동사 사용
시작하기 가이드 3부 캘린더 연결하기 내용 명시

도움말 센터의 검색 보고서를 확인하세요. 사람들이 입력하는 단어가 바로 제목에 사용해야 할 단어입니다.

도움말 아티클에 스크린샷과 동영상을 사용하는 방법은?

스크린샷은 컨트롤을 찾기 어렵거나 양식에 필드가 많을 때 가장 효과적입니다. 클릭 직전의 화면을 보여주고, 관련 부분만 자르고, 대상에 원이나 상자를 표시하세요. 실제 고객 데이터가 아닌 현실적인 샘플 데이터를 사용하세요. 스크린 리더와 검색을 위해 이미지 내용을 설명하는 대체 텍스트("초대 버튼이 표시된 멤버 페이지")를 작성하세요.

동영상은 단계가 많거나 드래그 앤 드롭, 타이밍이 중요한 작업, 온보딩에 유용합니다. 아티클 상단에 짧은 동영상을 배치하고 아래에 단계별 텍스트를 작성하세요. 시청을 원하는 독자는 영상을 보고, 6단계가 필요한 독자는 바로 해당 단계로 이동할 수 있습니다. Nielsen Norman Group의 교육용 동영상 연구에 따르면 예산이 허용하는 경우 정보성 콘텐츠에 텍스트와 동영상을 모두 포함할 것을 권장합니다. 사람들은 필요 없을 때는 영상을 무시하고 필요할 때만 활용합니다(NN/g, 2020).

UI가 변경되면 스크린샷과 동영상은 구식이 됩니다. 작업 녹화본으로 제작하면 15개의 스크린샷을 일일이 다시 찍을 필요 없이 작업 하나만 다시 녹화하면 됩니다.

AI 어시스턴트가 인용할 수 있는 아티클을 작성하는 방법은?

이제 더 많은 독자가 AI 답변을 통해 도움말 콘텐츠를 접합니다. 자체 도움말 센터 어시스턴트나 ChatGPT, Perplexity, Google의 AI 개요 등이 그 예입니다. Pew Research Center에 따르면 Google이 AI 요약을 보여줄 때 방문자의 8%만 기존 검색 결과를 클릭했고, 요약이 없을 때는 15%가 클릭했습니다 (2025). 이제 답변은 페이지가 아닌 인용된 곳에서 더 많이 읽힙니다. 훑어보는 사람에게 도움이 되는 습관이 AI 시스템이 올바른 구절을 선택하는 데도 도움이 됩니다:

  • 각 섹션을 독립적으로 만드세요. 어시스턴트는 특정 제목 아래의 내용만 인용할 수 있습니다. "그것"이나 "위와 같이" 대신 기능 이름을 반복하세요.
  • 질문 형태의 제목 바로 아래에 답변을 배치하세요. "결제 이메일을 어떻게 변경하나요?" 뒤에 바로 답변을 작성하세요.
  • 플랜, 역할, 설정의 정확한 이름을 사용하세요. "상위 플랜"보다 "Pro에서 사용 가능"이 더 좋습니다.
  • 사실은 이미지뿐만 아니라 텍스트로도 작성하세요. 어시스턴트는 스크린샷에만 나타나는 값을 읽을 수 없습니다.
  • 제한 사항을 명확히 밝히세요. "이 작업은 되돌릴 수 없습니다"라는 문장이 불필요한 문의를 방지합니다.

크롤러 접근, robots.txt 및 llms.txt에 대해서는 AI가 읽기 쉬운 문서 만드는 법을 참조하세요.

도움말 아티클을 최신 상태로 유지하는 방법은?

아티클은 릴리스마다 구식이 됩니다. 다음 세 가지 습관으로 관리할 수 있습니다:

  • 모든 아티클에 담당자와 "마지막 업데이트" 날짜를 지정하세요. 누군가는 책임을 져야 하며, 독자는 최근 날짜를 신뢰합니다.
  • 매 릴리스마다 확인하세요. 변경된 화면을 나열하고 해당 화면이 포함된 조회수 높은 아티클을 여세요. 라벨을 먼저 수정하고 스크린샷을 나중에 수정하세요. 문서를 최신 상태로 유지하기 위한 릴리스별 루틴을 확인하세요.
  • 변경된 작업을 다시 녹화하세요. 스크린샷과 동영상이 작업 녹화본에서 추출된 것이라면, 업데이트는 이미지를 일일이 다시 찍는 대신 짧게 다시 녹화하는 것으로 충분합니다.

도움말 아티클이 효과적인지 어떻게 알 수 있나요?

매달 아티클별로 다음 네 가지 수치를 확인하세요:

신호 확인 위치 의미
조회수 도움말 센터 분석 사람들이 아티클을 찾는지 여부
"도움이 되었나요?" 투표 및 댓글 아티클 피드백 질문에 대한 답변이 되었는지 여부
검색 결과 없음 도움말 센터 검색 보고서 새로 작성해야 할 아티클 및 제목에 빠진 단어
조회 후 동일 주제 문의 도움말 데스크(문의와 아티클 조회 연결 시) 실제 문의를 방지하는지 여부

조회수는 높지만 투표 결과가 나쁘고 동일 주제 문의가 꾸준히 들어오는 아티클은 가장 먼저 다시 작성해야 합니다. 공식은 문의 방지율 측정 방법을 참조하세요.

도움말 아티클 스타일 체크리스트

권장 지양
"저장을 클릭하세요." "변경 사항을 저장하려면 저장 버튼을 클릭하세요."
"관리자 역할이 필요합니다." "특정 권한이 필요할 수 있음을 유의하세요."
"이 작업은 되돌릴 수 없습니다." "주의해서 진행하세요."
2인칭, 현재 시제 "사용자는 ~로 이동해야 합니다."
문장당 하나의 아이디어 "그리고"로 세 번 이상 이어진 문장
UI와 정확히 일치하는 명칭 사용 동일 버튼에 대한 동의어 사용

Clevera로 더 빠르게 작업하기

Clevera는 화면 녹화본을 내레이션이 포함된 사용법 동영상, 단계별 도움말 아티클, 호스팅된 도움말 센터 페이지로 변환하는 AI 플랫폼으로 74개 언어를 지원합니다. 단계 목록, 스크린샷, 동영상 제작 등 위 방법의 번거로운 과정을 처리해 줍니다.

Mac 또는 Windows용 Clevera 데스크톱 앱으로 작업을 한 번 녹화하거나 기존 녹화본을 업로드하세요. 사용법 아티클 또는 문제 해결을 선택하고 깊이와 톤을 설정한 뒤 생성하세요. Clevera는 화면에서 일어나는 일과 사용자의 설명을 바탕으로 번호가 매겨진 단계를 작성합니다. 데스크톱 녹화 시 클릭 직전의 프레임을 선택하고 클릭 위치를 표시하며, 업로드된 동영상의 경우 AI가 직접 순간을 포착합니다.

화면 녹화본으로 Clevera가 작성한 사용법 아티클: 제목, 소개, 역할 콜아웃, 그리고 굵게 표시된 정확한 라벨이 포함된 1단계(샘플 앱 Acme Billing)
녹화본에서 추출한 아티클 스크린샷: New invoice 주위에 녹색 원이 표시된 샘플 앱의 Invoices 화면과 아래 캡션

고객의 언어로 된 제목, 녹화본에 담을 수 없는 사전 요구 사항, 동료와 함께하는 테스트 등 판단이 필요한 부분은 직접 수행하세요. 동일한 녹화본으로 Clevera는 아티클 상단에 배치할 내레이션이 포함된 사용법 동영상도 제작할 수 있습니다.

그런 다음 검색 기능, 기사 내용을 바탕으로 답변하고 출처를 제공하는 Ask AI 어시스턴트, 독자 피드백 기능을 갖춘 호스팅된 헬프 센터에 게시하세요. 헬프 센터는 무료 플랜을 포함한 모든 플랜에서 제공되며, 자체 도메인을 사용하려면 Starter 플랜이 필요합니다. 인사이트 기능을 통해 검색 결과가 없는 키워드를 확인할 수 있으므로 다음에 작성해야 할 기사가 무엇인지 파악할 수 있습니다.

Clevera 헬프 센터 인사이트의 콘텐츠 공백: 환불, csv로 내보내기, 싱글 사인온(SSO) 등 검색 결과가 없는 키워드와 각각의 '기사 작성' 및 '완료 표시' 버튼

무료 플랜은 매달 100크레딧과 최대 3분 분량의 녹화 기능을 제공하며, 기사 하나당 보통 5~15크레딧이 소모됩니다. Starter 플랜은 연간 결제 시 월 29달러(월간 결제 시 36달러)입니다. 가격은 2026년 11월 3일 기준이며, 가격 정책을 확인하세요.

녹화본 대신 메모로 시작하고 싶다면, 무료 헬프 기사 생성기를 사용하여 대략적인 메모를 구조화된 기사로 변환해 보세요. 별도의 가입은 필요하지 않습니다.

무료로 시작하기, 헬프 센터에서 녹화본을 기사로 바꾸는 방법 읽기, 또는 Clevera가 헬프 센터 소프트웨어로서 어떻게 작동하는지 확인해 보세요.

FAQ

헬프 센터 기사는 어느 정도 길이가 적당한가요? 작업을 설명하는 데 필요한 만큼만 작성하세요. 일반적으로 방법 안내 기사는 150600단어, 312단계로 구성하는 것이 좋습니다. 12단계가 넘어가거나 여러 개의 제목이 필요하다면 기사를 두 개로 나누는 것이 좋습니다.

모든 헬프 기사에 스크린샷을 넣어야 하나요? 아니요. 찾기 어려운 컨트롤, 여러 필드가 있는 양식, 완료 상태 등 사용자가 길을 잃기 쉬운 곳에만 추가하세요. 모든 단계에 스크린샷을 넣으면 기사가 너무 길어지고 더 빨리 구식이 됩니다.

헬프 센터 기사와 지식 베이스(Knowledge Base) 기사의 차이점은 무엇인가요? 보통 차이가 없습니다. "헬프 센터"는 고객이 보는 사이트를 의미하고(차이점에 대해 더 알아보기), "지식 베이스"는 기사 모음을 의미하며 때로는 내부용 문서를 뜻하기도 합니다. 작성 규칙은 동일합니다.

헬프 센터 기사는 누가 작성해야 하나요? 해당 주제에 대한 문의를 직접 처리하는 담당자가 작성하고, 편집자가 일관성을 검토하는 것이 좋습니다. 지원 담당자는 실제 질문과 사용자가 사용하는 용어를 가장 잘 알고 있습니다. 기능이 변경될 때는 제품 팀이 정확성을 검토해야 합니다.

헬프 기사는 얼마나 자주 업데이트해야 하나요? 설명하는 UI나 동작이 변경될 때마다, 그리고 최소 1년에 한 번은 업데이트해야 합니다. 모든 기사에 담당자와 "마지막 업데이트" 날짜를 표시하고, 릴리스 후에는 가장 많이 조회된 기사를 확인하세요.

AI가 헬프 센터 기사를 작성할 수 있나요? 특히 작업 녹화본이나 메모를 바탕으로 탄탄한 초안을 작성할 수 있습니다. 다만 사람이 직접 제품과 비교하여 라벨을 확인하고, 필수 요건을 추가하며, 단계를 테스트하는 과정은 여전히 필요합니다.