업무 문서는 개인 스페이스가 아니라 공용 스페이스에 전체 공유를 기본으로 작성하고, 키워드 기반 제목과 한 줄 요약을 붙이며, 게시를 눌러야 검색과 멘션이 된다.
기본 원칙
공용 스페이스에 작성한다 개인 스페이스는 개인 메모용이다. 업무 관련 문서는 반드시 그룹·스쿼드·프로젝트 공용 스페이스에 작성한다.
전체 공유를 기본으로 한다 문서를 만들 때 기본 권한을 「모두 보기」로 설정한다. 민감하거나 보안이 필요한 경우에만 접근 권한을 제한한다.
검색 가능한 제목을 붙인다
[회의] 2025-11-03 PM 3파트, [정책] 휴가 프로세스 처럼 키워드 기반 제목을 쓴다.
요약을 먼저 쓴다 문서 첫 문단에 「이 문서는 무엇을 위한 문서인지」를 한 줄로 적는다.
문서만 검색하는 방법
지라 이슈와 첨부파일, 드라이브, 슬랙을 제외하고 검색할 때 쓴다.
| 목표 | 설정 방법 |
|---|---|
| 키워드는 아는데 문서가 나오지 않는다 | 공백을 포함한 전체 문장을 큰따옴표로 감싼다 |
| 지라 이슈 제외 | 「Search in: Confluence」를 고른다 |
| 첨부파일 제외 | -type:attachment 또는 Type → Documents 를 고른다 |
| 공간 한정 | spaceKey: 또는 왼쪽 Space 필터를 쓴다 |
| 개인 위키 스페이스 제외 | -spaceKey:~username 구문을 추가한다. 틸드(~)는 개인 스페이스를 뜻한다 |
| 레이블로 세밀하게 | labelText: 를 쓴다 |
공간 구조와 폴더링
위키는 「공간(Space)」과 「페이지 트리」로 구조화돼 있다. 내 문서가 어디에 있어야 다른 사람이 자연스럽게 찾을 수 있을지를 먼저 정한다.
| 개념 | 설명 | 예시 |
|---|---|---|
| 공간(Space) | 문서가 속하는 상위 영역 (HRBP&TA, CP개발그룹, 미리클스쿼드 등) | 기능조직과 목표조직별로 운영한다 |
| 페이지 트리(Page Tree) | 페이지 간 계층 구조 (왼쪽 메뉴 트리) | [정책], [회의록], [실험] 등으로 분류 |
| 하위 페이지(Sub Page) | 큰 문서 아래 관련 문서를 묶는 방식 | 「11월 스프린트 리뷰」를 「스쿼드 리뷰」 하위로 |
라이브 페이지와 게시
위키 문서는 초안 상태로만 두면 검색되지 않는다. 「게시(Publish)」 버튼을 눌러야 팀원이 볼 수 있다.
| 상황 | 동작 | 비고 |
|---|---|---|
| 작성 중 | 「초안」 상태이며 본인만 열람할 수 있다 | 상단에 「이 페이지는 게시되지 않았습니다」가 표시된다 |
| 완료 후 | 「게시(Publish)」를 누른다 | 게시한 뒤에야 링크 공유와 검색, 멘션이 가능하다 |
| 라이브 페이지 | 수정 내용이 자동 저장된다 | 업데이트를 누르지 않아도 변경 내용이 반영되며 동시 작업이 가능하다 |
버전 기록과 열람 설정
위키는 문서가 「언제, 누가, 무엇을 바꿨는지」를 모두 자동으로 기록한다. 실험 로그나 정책 변경 같은 이력을 안전하게 관리할 수 있다.
오른쪽 상단의 「공유(Share)」를 누르면 권한을 설정할 수 있다.
기본적으로 상위 문서의 접근 권한을 따라간다. 상위 문서가 「강미리A」와 「강미리B」에게만 공유돼 있으면 그 하위 문서를 「강미리C」에게 공유할 수 없다.
··· 메뉴에서 할 수 있는 것
- 별표 표시로 즐겨찾기에 추가한다.
- 관찰 설정으로 갱신 내용을 알림받는다.
- 버전 기록으로 페이지 이력과 수정 내역, 수정자를 본다. 특정 버전으로 되돌릴 수도 있다.
간단 사용 팁
| 기능 | 사용법 | 설명 |
|---|---|---|
| 날짜 입력 | // + Enter |
오늘 날짜가 자동 입력된다 |
| 멘션 | @이름 |
해당 사람에게 알림이 간다. 공유된 문서여야 알림이 전달된다 |
| 댓글 남기기 | 문장 드래그 → 「댓글」 아이콘 | 특정 문장에 코멘트할 수 있다 |
| 이모지 리액션 | 댓글이나 문서 상단에서 이모지 추가 | 멘션된 코멘트나 공유된 문서에 확인·공감 표시를 남긴다 |
| 체크박스 | [] 입력 |
간단한 할 일 목록을 만든다 |
| 불릿포인트 | - 입력 |
순서 없는 목록 |
| 번호목록 | 1. 입력 |
순서 있는 목록 |
| 구분선 | --- 입력 |
문단을 나눈다 |
문단과 스타일
| 기능 | 사용법 | 설명 |
|---|---|---|
| 문단 나누기 | Enter | 문단을 구분한다 |
| 줄바꿈 (같은 문단 내) | Shift+Enter | 문단이 분리되지 않는다 |
| 머릿글 스타일 | Ctrl + Alt + 1/2/3 | 제목 구조를 유지한다. 링크 공유와 목차 매크로에 유리하다 |
| 이미지 삽입 | 이미지 붙여넣기 → 크기 조절 | 줄글 가운데 작게 넣을 수도 있다 |
| 인용문 | > 입력 |
참고나 메시지를 강조할 때 |
| 펼치기 | /펼치기 |
문서가 길어지지 않게 내용을 숨기거나, 참고 내용과 이력을 포함할 때 |
| 코드 강조 | Ctrl + Shift + M | 키워드, 명령어, 경로 등 짧은 강조에 적합하다 |
| 패널 매크로 | /패널 |
참고사항, 주의, 예시 등을 시각적으로 구분한다 |
| 상태 매크로 | /상태 |
진행 상태를 표시하거나 강조한다 (진행 중·완료·기타 강조) |
| 표 만들기 | /표 |
내용을 정리하거나 비교할 때 |
문서 레이블 활용
레이블로 관련 주제의 문서를 한 번에 찾거나 모아 볼 수 있다.
| 항목 | 설명 |
|---|---|
| 레이블(Label) | 문서에 붙이는 태그다. 같은 레이블을 가진 문서끼리 자동으로 묶인다 |
| 위치 | 문서 하단의 「레이블 추가(Add label)」 영역에서 관리한다 |
| 검색 연동 | 검색창에서 labelText: 로 검색하면 해당 레이블이 붙은 문서만 볼 수 있다 |
관련 문서
| 대상 | 경로 |
|---|---|
| 위키 권한 정책 | corporate/work-tools/wiki-permission-policy.md |
| 위키 임시본과 자동 저장 | corporate/work-tools/wiki-draft-and-publish.md |
| 기본 업무 도구 안내 | corporate/work-tools/work-tools-overview.md |