위키(컨플루언스) 사용 가이드

기본 원칙

공용 스페이스에 작성한다 개인 스페이스는 개인 메모용이다. 업무 관련 문서는 반드시 그룹·스쿼드·프로젝트 공용 스페이스에 작성한다.

전체 공유를 기본으로 한다 문서를 만들 때 기본 권한을 「모두 보기」로 설정한다. 민감하거나 보안이 필요한 경우에만 접근 권한을 제한한다.

검색 가능한 제목을 붙인다 [회의] 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