이 가이드에서 해결하는 문제
사내 정책, 사용자 매뉴얼, 프로젝트 안내서처럼 내용이 긴 문서는 정보가 많아질수록 필요한 항목을 찾기 어려워집니다. 노션의 콜아웃, 토글, 토글 헤딩을 함께 사용하면 문서의 핵심은 바로 보여주고, 상세 내용은 필요할 때만 펼쳐보는 구조를 만들 수 있습니다.
1. 세 가지 블록은 각각 언제 사용하나요?
긴 문서를 깔끔하게 정리하려면 모든 내용을 무조건 접는 것이 아니라, 정보의 역할에 따라 블록을 구분해야 합니다.
블록 | 주요 역할 | 적합한 내용 | 권장 사용 위치 |
콜아웃 | 중요한 정보를 시각적으로 강조 | 요약, 주의사항, 담당자, 변경 사항 | 문서 상단 또는 관련 섹션 바로 아래 |
토글 | 짧은 상세 정보를 접어서 보관 | FAQ 답변, 용어 설명, 예외 조건, 참고 자료 | 본문의 세부 항목 아래 |
토글 헤딩 | 긴 섹션 전체를 접고 펼침 | 정책 챕터, 업무 절차, 부서별 안내 | 문서의 주요 장 구분 |
콜아웃을 사용하면 좋은 경우
- 문서를 열자마자 반드시 확인해야 하는 핵심 요약
- 적용 대상, 시행일, 담당 부서처럼 놓치면 안 되는 정보
- 주의, 금지, 예외처럼 오해하기 쉬운 내용
- 문서가 최근 변경되었다는 안내
토글을 사용하면 좋은 경우
- 질문을 클릭하면 답변이 나타나는 FAQ
- 본문 흐름에는 필요하지만 모든 사용자가 읽을 필요는 없는 세부 설명
- 예시, 참고 링크, 용어 정의
- 특정 조건에만 적용되는 예외 규칙
토글 헤딩을 사용하면 좋은 경우
- 한 섹션이 3~4문단 이상 이어지는 경우
- 사용자가 자신에게 필요한 챕터만 골라 읽어야 하는 경우
- 부서별, 역할별, 단계별로 내용이 명확히 나뉘는 경우
가장 쉬운 판단 기준
“항상 보여야 하는가?”에 따라 결정하세요. 항상 보여야 하는 핵심은 일반 본문이나 콜아웃으로 두고, 일부 사용자에게만 필요한 상세 내용은 토글에 넣습니다.
2. Before / After: 긴 문서를 어떻게 바꿀 수 있나요?
Before: 모든 내용이 펼쳐진 문서
사내규정_인사정책_v5.docx처럼 모든 챕터와 세부 규정이 한 번에 보이는 문서는 다음 문제가 생깁니다.- 원하는 항목을 찾기 위해 긴 문서를 계속 스크롤해야 합니다.
- 중요한 공지와 세부 설명의 시각적 우선순위가 비슷합니다.
- 자신과 관계없는 내용까지 모두 읽어야 하는 것처럼 보입니다.
- 문서가 업데이트될수록 구조가 복잡해집니다.
After: 핵심과 상세가 분리된 문서
같은 내용을 다음과 같이 3단으로 나누면 훨씬 빠르게 탐색할 수 있습니다.
- 콜아웃: 문서 목적, 적용 대상, 핵심 변경 사항
- 토글 헤딩: 신청 방법, 승인 기준, 정산 절차 같은 주요 챕터
- 일반 토글: 예외 조건, 작성 예시, 자주 묻는 질문
사용자는 먼저 전체 구조를 확인한 뒤 필요한 챕터만 펼칠 수 있습니다. 문서 작성자는 중요한 정보가 토글 안에 묻히지 않도록 우선순위를 명확하게 표현할 수 있습니다.
3. Step-by-Step: 콜아웃 만들기
Step 1. 콜아웃 블록 추가하기
빈 줄에서
/callout을 입력한 뒤 나타나는 콜아웃 블록을 선택합니다. 문서 상단에는 문서 전체를 요약하는 콜아웃을 하나 배치하는 것이 좋습니다.Step 2. 콜아웃 목적에 맞는 아이콘 선택하기
콜아웃의 아이콘을 클릭해 내용의 성격을 한눈에 알 수 있는 이모지로 바꿉니다.
- 📌 핵심 요약 또는 필수 정보
- 💡 팁 또는 권장 사항
- ⚠️ 주의 또는 사전 확인
- 🚫 금지 또는 보안 위험
- ✅ 완료 조건 또는 체크 항목
- 📅 일정 또는 시행일
Step 3. 배경색으로 의미 구분하기
블록 메뉴의 색상 설정에서 배경색을 선택합니다. 색상은 장식보다 의미 구분에 사용하는 것이 좋습니다.
- 파란색: 일반 안내 또는 핵심 요약
- 노란색: 팁 또는 검토 필요
- 주황색·빨간색: 주의, 위험, 금지
- 초록색: 완료, 승인, 권장 절차
- 회색: 참고 정보 또는 부가 설명
색상을 너무 많이 사용하지 마세요.
한 문서에서 2~3개의 의미 체계만 정해 일관되게 사용하세요. 같은 노란색이 어떤 곳에서는 팁이고 다른 곳에서는 위험을 의미하면 사용자가 내용을 빠르게 구분하기 어렵습니다.
Step 4. 콜아웃 안에 여러 블록 넣기
콜아웃은 한 줄짜리 강조 상자뿐 아니라 여러 블록을 담는 컨테이너로도 사용할 수 있습니다.
- 페이지에 토글, 체크리스트, 문단 등 필요한 블록을 먼저 만듭니다.
- 블록 왼쪽의
⋮⋮핸들을 잡습니다.
- 해당 블록을 콜아웃 안쪽으로 드래그합니다.
- 파란색 가이드 선이 콜아웃 내부에 표시되는지 확인한 뒤 놓습니다.
여러 블록을 한 번에 옮기려면 먼저 블록들을 드래그해 선택한 다음 콜아웃 안으로 이동합니다.
4. Step-by-Step: 일반 토글 만들기
방법 A. 슬래시 명령어 사용
- 빈 줄에서
/toggle을 입력합니다.
- 메뉴에서 토글 블록을 선택합니다.
- 사용자가 펼치기 전에 볼 제목을 입력합니다.
- 토글을 펼친 뒤 안쪽에 설명, 이미지, 목록 또는 다른 블록을 작성합니다.
방법 B. 마크다운 단축 입력 사용
줄 맨 앞에서
>를 입력하고 스페이스바를 누르면 토글을 빠르게 만들 수 있습니다. 환경이나 앱 버전에 따라 입력 동작이 다를 수 있으므로, 예상대로 만들어지지 않으면 /toggle 명령을 사용하세요.좋은 토글 제목 작성법
토글 제목만 읽어도 안에 어떤 내용이 있는지 예상할 수 있어야 합니다.
피해야 할 제목 | 권장 제목 |
자세히 보기 | 법인카드 사용이 제한되는 항목 |
참고 | 해외 결제 시 필요한 증빙 자료 |
예외 | 팀장 승인 없이 구매할 수 있는 경우 |
FAQ | 영수증을 분실하면 어떻게 하나요? |
5. Step-by-Step: 토글 헤딩 만들기
토글 헤딩은 일반 헤딩처럼 문서의 구조를 보여주면서, 해당 섹션에 포함된 블록을 한꺼번에 접을 수 있게 합니다.
방법 A. 슬래시 메뉴에서 만들기
- 빈 줄에서
/toggle heading을 입력합니다.
- 원하는 크기의 토글 헤딩을 선택합니다.
- 챕터 제목을 입력합니다.
- 하위에 포함할 문단, 목록, 이미지, 데이터베이스 등을 헤딩 아래에 배치합니다.
- 토글을 접어 하위 블록이 함께 숨겨지는지 확인합니다.
방법 B. 기존 블록을 변환하기
- 기존 헤딩이나 토글 왼쪽의
⋮⋮핸들을 클릭합니다.
- 전환 또는 Turn into 메뉴를 엽니다.
- 원하는 크기의 토글 헤딩을 선택합니다.
키보드로 메뉴를 열려면 블록에 커서를 둔 상태에서
Cmd/Ctrl + /를 사용할 수 있습니다.토글 헤딩 크기 선택 기준
- 가장 큰 토글 헤딩: 문서의 주요 챕터
- 중간 토글 헤딩: 챕터 내부의 절차 또는 주제
- 작은 토글 헤딩: 세부 항목을 다시 그룹화해야 할 때
한 문서에서는 2~3단계까지만 사용하는 것이 좋습니다. 접힘 구조가 너무 깊으면 사용자가 현재 위치를 파악하기 어려워집니다.
6. 권장 문서 구조
다음 구조는 정책, 매뉴얼, 고객 안내서에 공통으로 적용하기 좋습니다.
- 문서 상단
- 문서 목적
- 적용 대상
- 담당 부서 또는 문의처
- 핵심 변경 사항
- 주요 챕터
- 토글 헤딩으로 구분
- 각 챕터 첫 문장에 핵심 결론 표시
- 세부 정보
- 예외, 사례, 용어 설명은 일반 토글 사용
- 문서 하단
- 자주 묻는 질문
- 관련 문서
- 마지막 업데이트 날짜
예시: 비용 처리 가이드
- 상단 콜아웃: 적용 대상, 제출 마감일, 문의 담당자
- 토글 헤딩 1: 비용 처리 대상
- 토글: 처리 가능한 비용 예시
- 토글: 처리할 수 없는 비용 예시
- 토글 헤딩 2: 신청 방법
- 1단계: 영수증 준비
- 2단계: 신청서 작성
- 3단계: 승인 요청
- 토글 헤딩 3: 승인 및 지급 일정
- 토글 헤딩 4: 자주 묻는 질문
예시: 고객 온보딩 매뉴얼
- 상단 콜아웃: 온보딩 목표와 예상 소요 시간
- 토글 헤딩 1: 계정 생성
- 토글 헤딩 2: 워크스페이스 설정
- 토글 헤딩 3: 사용자 초대
- 토글 헤딩 4: 권한 점검
- 일반 토글: 단계별 오류 해결, 용어 설명, 추가 참고 자료
7. 문서를 실제로 재구성하는 순서
기존의 긴 문서를 한 번에 새로 쓰기보다 다음 순서로 정리하면 실수가 적습니다.
- 문서 목적 정하기
- 사용자가 문서를 읽고 무엇을 이해하거나 수행해야 하는지 한 문장으로 작성합니다.
- 핵심 정보 표시하기
- 반드시 읽어야 하는 문장에 표시하고 토글 안으로 숨기지 않습니다.
- 챕터 나누기
- 한 문서에 5~9개의 주요 챕터가 보이도록 내용을 묶습니다.
- 토글 헤딩으로 변환하기
- 길이가 긴 챕터를 토글 헤딩으로 바꿉니다.
- 세부 설명 접기
- 예시, 예외, FAQ를 일반 토글 안으로 이동합니다.
- 콜아웃 추가하기
- 문서 요약, 경고, 담당자 등 핵심 정보에만 사용합니다.
- 접힌 상태에서 검토하기
- 모든 토글을 접었을 때 제목만 읽어도 전체 내용을 파악할 수 있는지 확인합니다.
- 사용자 관점에서 테스트하기
- 문서를 처음 보는 사람이 원하는 정보를 30초 안에 찾을 수 있는지 확인합니다.
8. 가독성을 높이는 작성 원칙
제목은 행동 또는 질문 중심으로 작성하기
“기타”, “상세”, “안내”처럼 모호한 제목보다 “게스트를 초대하는 방법”, “승인이 반려되는 경우”처럼 구체적인 제목이 좋습니다.
한 토글에는 하나의 주제만 넣기
서로 다른 내용이 한 토글에 들어가면 사용자는 원하는 정보를 찾기 위해 토글 내부를 다시 탐색해야 합니다. 내용이 길어지면 토글을 나누거나 토글 헤딩으로 승격합니다.
핵심 결론을 토글 밖에 두기
마감일, 금지 사항, 필수 준비물, 담당자처럼 모든 사용자가 알아야 하는 내용은 접힌 영역에 넣지 않습니다.
접힘 단계를 과도하게 만들지 않기
토글 안에 토글을 반복해서 넣으면 정보가 어디에 있는지 기억하기 어렵습니다. 일반적으로 주요 챕터와 세부 항목의 2단 구조면 충분합니다.
제목 형식을 통일하기
같은 수준의 제목은 같은 문장 형식을 사용하세요.
- 절차형: 계정 만들기 / 사용자 초대하기 / 권한 점검하기
- 질문형: 누가 신청할 수 있나요? / 언제 지급되나요? / 반려되면 어떻게 하나요?
- 명사형: 적용 대상 / 승인 기준 / 지급 일정
9. 초보자가 자주 하는 실수
실수 1. 모든 섹션을 토글로 만든다
모든 내용을 접으면 문서가 짧아 보이지만, 사용자는 매번 토글을 열어봐야 합니다.
해결 방법: 핵심 설명은 펼쳐두고, 부가 정보와 긴 예시만 접습니다.
실수 2. 모든 섹션을 굵은 글씨로만 구분한다
굵은 글씨는 강조일 뿐 문서 구조를 만들지 못합니다. 목차와 탐색 구조를 고려해 일반 헤딩 또는 토글 헤딩을 사용합니다.
실수 3. 토글 제목을 모호하게 쓴다
“자세히 보기”, “참고”, “예외” 같은 제목만으로는 내용을 예측할 수 없습니다.
해결 방법: 토글 제목 자체에 대상과 상황을 적습니다.
실수 4. 콜아웃을 장식처럼 반복한다
콜아웃이 너무 많으면 어떤 내용이 정말 중요한지 구분할 수 없습니다.
해결 방법: 문서 상단 요약과 중요한 경고·팁에만 제한적으로 사용합니다.
실수 5. 중요한 내용을 토글 안에 숨긴다
마감일이나 필수 절차가 기본적으로 접혀 있으면 사용자가 놓칠 수 있습니다.
해결 방법: 반드시 읽어야 하는 정보는 본문 또는 콜아웃에 배치합니다.
실수 6. 블록이 콜아웃 밖에 놓인 줄 모르고 작업한다
드래그할 때 가이드 선을 확인하지 않으면 블록이 콜아웃 아래에 놓일 수 있습니다.
해결 방법: 블록을 옮긴 뒤 콜아웃 전체를 이동해 내부 블록이 함께 움직이는지 확인합니다.
10. 게시 전 체크리스트
구조
문서 상단에 목적과 핵심 요약이 있다.
주요 챕터가 헤딩 또는 토글 헤딩으로 구분되어 있다.
모든 토글을 접어도 문서의 전체 흐름을 이해할 수 있다.
접힘 구조가 2~3단계를 넘지 않는다.
내용
필수 정보와 마감일이 토글 안에 숨겨져 있지 않다.
각 토글에는 하나의 주제만 들어 있다.
제목만 읽어도 내부 내용을 예상할 수 있다.
예시와 예외 조건이 명확하게 구분되어 있다.
디자인
콜아웃 색상과 아이콘의 의미가 일관적이다.
콜아웃이 지나치게 많이 사용되지 않았다.
같은 수준의 헤딩 크기와 표현 방식이 통일되어 있다.
긴 문단이 목록이나 단계로 적절히 나뉘어 있다.
사용성
처음 보는 사용자가 필요한 정보를 빠르게 찾을 수 있다.
데스크톱과 모바일에서 모두 읽기 편하다.
링크와 첨부 자료가 정상적으로 열리는지 확인했다.
문서 담당자와 마지막 업데이트 날짜가 표시되어 있다.
11. 자주 묻는 질문
토글은 많이 사용할수록 좋은가요?
아닙니다. 토글은 중요도가 낮거나 일부 사용자에게만 필요한 내용을 정리할 때 효과적입니다. 핵심 내용까지 모두 접으면 오히려 탐색 단계가 늘어납니다.
일반 헤딩과 토글 헤딩 중 무엇을 사용해야 하나요?
항상 펼쳐 보여야 하는 짧은 섹션은 일반 헤딩을, 내용이 길거나 사용자가 필요한 부분만 선택해서 읽어야 하는 섹션은 토글 헤딩을 사용하세요.
토글 안에 이미지나 체크리스트를 넣을 수 있나요?
네. 토글을 펼친 뒤 내부에 이미지, 목록, 체크리스트 등 다양한 블록을 배치할 수 있습니다. 기존 블록은 드래그해서 토글 안으로 이동할 수 있습니다.
콜아웃 안에 토글을 넣을 수 있나요?
네. 토글 블록을 콜아웃 내부로 드래그하면 됩니다. 다만 콜아웃 안에 너무 많은 내용을 넣으면 강조 효과가 약해지므로 요약, 주의사항, 짧은 체크리스트 중심으로 사용하는 것이 좋습니다.
토글 제목도 검색되나요?
페이지 검색이나 브라우저의 찾기 기능은 환경과 표시 상태에 따라 경험이 달라질 수 있습니다. 검색에 꼭 노출되어야 하는 핵심 용어는 토글 제목이나 펼쳐진 본문에도 명확하게 작성하세요.
문서를 열 때 모든 토글을 펼쳐야 하나요?
사용자가 처음 보아야 하는 핵심 정보는 애초에 토글 밖에 두는 것이 좋습니다. 세부 설명은 기본적으로 접힌 구조를 유지하고, 문서 목적에 따라 필요한 챕터만 펼쳐서 안내할 수 있습니다.
12. 권장 구성 요약
긴 문서를 정리하는 기본 공식
- 문서 상단의 콜아웃에 목적, 대상, 핵심 변경 사항을 적습니다.
- 주요 챕터는 토글 헤딩으로 구분합니다.
- 예시, 예외, FAQ는 일반 토글에 넣습니다.
- 마감일, 금지 사항, 필수 절차는 접지 않고 항상 보이게 둡니다.
- 모든 토글을 접은 상태에서 제목만 읽어도 전체 구조가 이해되는지 확인합니다.
가독성은 문서를 짧게 보이게 만드는 것보다, 사용자가 필요한 정보를 빠르게 찾도록 만드는 데서 시작합니다. 콜아웃은 우선순위를 보여주고, 토글 헤딩은 큰 구조를 정리하며, 일반 토글은 세부 정보를 단계적으로 제공하는 역할로 사용하세요.