매뉴얼 제작에서 먼저 맞춰야 할 Word의 기본 - 나쁜 패턴과 베스트 프랙티스를 나란히 정리
· 小村 豪 · Word, 매뉴얼 제작, 문서 설계, 업무 개선
조작 매뉴얼, 작업 절차서, 유지보수 절차, 사내용 운용서.
이런 문서에서 나중에 영향이 오는 것은 글솜씨 자체가 아니라, Word를 「보이는 것만 정돈하는 도구」로 쓰고 있지는 않은지입니다.
처음에는 빨라 보이는 방식이라도,
- 제목을 굵은 글씨와 글자 크기만으로 만든다
- 스페이스나 Tab을 연타해 위치를 맞춘다
- Enter를 여러 번 눌러 페이지를 넘긴다
- 목차나 페이지 참조를 손으로 친다
- 수정 요청을 빨간 글자 그대로 본문에 섞어 둔다
이런 것들이 섞이면 개정할 때마다 무너집니다.
이 글에서는 매뉴얼 제작 시 정말로 필요해지는 Word의 기본을, 나쁜 패턴과 베스트 프랙티스를 나란히 늘어놓는 형태로 정리합니다.
전제는 주 형식을 .docx로 한 Word 데스크톱 버전 중심의 운용입니다.
1. 먼저 결론
먼저 결론만 늘어놓으면, 매뉴얼 제작에서는 다음 4가지가 중요합니다.
-
구조를 Word의 기능에 맡긴다
제목, 번호, 목차, 참조, 페이지 제어는 손으로 치지 말고, Word의 스타일·필드·구분을 써서 관리합니다. -
위치 맞춤을 공백 문자에 맡기지 않는다
스페이스, Tab 연타, 빈 줄 연타는 나중에 고칠 때마다 무너집니다. 단락 설정, 들여쓰기, 표, 섹션을 씁니다. -
리뷰를 본문에 섞지 않는다
수정 지시는 빨간 글자 본문이 아니라, 댓글(메모)과 변경 내용 추적으로 분리합니다. 최종판에서 무엇이 확정되었는지가 명확해집니다. -
배포 직전에 자동 요소를 갱신한다
목차, 페이지 번호, 상호 참조, 그림·표 번호는 마지막에 한꺼번에 갱신합니다. PDF화 전에 접근성도 확인합니다.
2. Word를 손으로 맞추는 도구로 쓰지 않는다
매뉴얼 제작에서 가장 중요한 것은 보이는 것과 구조를 나누는 것입니다.
예를 들어, 다음은 본래 「구조」입니다.
- 장, 절, 소제목
- 절차 1, 절차 2, 절차 3
- 그림 2-1, 표 3-2
- 제 4 장을 참조
- 타이틀 페이지만 페이지 번호 없음
- 개정 시의 수정 이력
하지만 무너지기 쉬운 문서는 이 구조를 전부 「보이는 것의 조정」으로 때우려고 합니다.
- 문자를 크게 해서 제목처럼 보이게 한다
1.을 손으로 친다- 스페이스로 맞춘다
- Enter로 페이지를 넘긴다
- 「3페이지 참조」라고 쳐넣는다
이 방식이면 한 곳만 고쳐도 다른 곳까지 무너집니다.
Word에는 제목 스타일, 목차, 단락 설정, 다단계 목록, 머리글 / 바닥글, 섹션 구분, 캡션, 변경 내용 추적, 접근성 검사 등 문서를 구조로 담기 위한 기능이 처음부터 있습니다.
매뉴얼에서는 이 기본만 써도 사고가 상당히 줄어듭니다.
3. 나쁜 패턴과 베스트 프랙티스 일람
| 항목 | 나쁜 패턴 | 베스트 프랙티스 |
|---|---|---|
| 제목 | 굵은 글씨 + 글자 크기만으로 장을 구성한다 | 제목 1 / 제목 2 / 제목 3을 쓴다 |
| 위치 맞춤 | 스페이스나 Tab 연타로 맞춘다 | 단락 설정, 들여쓰기, 탭 위치, 표를 쓴다 |
| 페이지 제어 | Enter 연타로 다음 페이지로 보낸다 | 페이지 나누기, 섹션 구분을 쓴다 |
| 목차 | 목차를 손으로 친다 | 제목 스타일 + 자동 목차로 한다 |
| 절차 번호 | 1. 2. 3.을 손으로 친다 |
번호 매기기 / 다단계 목록을 쓴다 |
| 머리글·바닥글 | 페이지마다 직접 입력한다 | 머리글 / 바닥글과 페이지 번호를 쓴다 |
| 그림과 표 | 이미지를 붙이기만 하고 표제 없음 | 캡션, 본문 보충, 대체 텍스트를 붙인다 |
| 수정 | 빨간 본문이나 색 구분을 그대로 남긴다 | 변경 내용 추적과 댓글로 리뷰한다 |
| 참조 | 「3페이지 참조」, 「위 그림」을 손으로 쓴다 | 상호 참조와 필드 갱신을 쓴다 |
| 서식 규칙 | 사람마다 보이는 모습이 다르다 | 템플릿과 스타일을 먼저 정한다 |
4. 실무에서 놓치지 말아야 할 포인트
4.1 제목을 굵은 글씨와 글자 크기만으로 만든다
나쁜 패턴
문자를 크게 하고 굵게 해서 「제목 같아 보이게」만 해서 끝낸다.
무엇이 괴로운가
Word는 그 줄을 정식 제목으로 취급하지 않습니다.
탐색 창에서 이동하기 어렵고, 자동 목차에도 들어가지 않습니다. 접근성 측면에서도 겉모습만의 제목은 불리합니다.
베스트 프랙티스
장·절·소제목에 제목 1 / 제목 2 / 제목 3을 할당합니다.
보이는 모습을 바꾸고 싶을 때는 줄 단위로 굵기나 글자 크기를 만지지 말고, 스타일 쪽을 편집합니다.
4.2 스페이스나 Tab 연타로 위치를 맞춘다
나쁜 패턴
조작명과 설명문 사이를 스페이스로 메운다, 오른쪽 끝의 버전 번호를 Tab 연타로 붙인다, 빈 줄을 여러 개 넣어 단락 간격 대신 쓴다.
무엇이 괴로운가
문구가 한 글자 늘기만 해도 무너집니다.
글꼴 변경, 단락 추가, PDF화, 공동 편집에서도 어긋나기 쉽습니다.
베스트 프랙티스
위치나 여백은 문자가 아니라 단락 설정에 맡깁니다.
들여쓰기, 탭 위치, 단락 앞뒤 간격, 필요하면 표를 씁니다.
4.3 Enter 연타로 페이지를 넘긴다
나쁜 패턴
다음 장을 다음 페이지부터 시작하고 싶어 Enter를 여러 번 눌러 보낸다.
무엇이 괴로운가
위 페이지에서 1줄이 늘어난 순간 전부 어긋납니다.
빈 페이지가 섞이거나, 제목만 앞 페이지에 남거나, 의도하지 않은 위치에서 머리글·바닥글이 바뀌기도 합니다.
베스트 프랙티스
장의 머리는 페이지 나누기, 페이지 번호나 머리글 / 바닥글의 취급을 바꾸고 싶은 곳은 섹션 구분을 씁니다.
무너졌을 때는 ¶ 표시를 켜고, 페이지 나누기와 단락 기호가 보이는 상태로 확인합니다.
4.4 목차·번호·상호 참조를 손으로 치지 않는다
나쁜 패턴
목차 페이지를 손으로 만들고, 장 이름과 페이지 번호를 매번 다시 친다.
1. 2. 3.이나 1.1 1.2를 본문에 직접 친다.
「12페이지 참조」「그림 3을 참조」라고 그대로 문자로 쓴다.
무엇이 괴로운가
개정할 때마다 갱신 누락이 나옵니다.
페이지 번호만 고치고, 제목 이름이 옛것 그대로 남는, 같은 사고도 일어나기 쉽습니다.
베스트 프랙티스
제목 스타일을 사용해 자동 목차를 만듭니다.
절차는 번호 매기기, 장·절 체계는 다단계 목록으로 담습니다.
그림 번호, 페이지 번호, 장 번호에 대한 참조는 상호 참조나 필드로 담고, 마지막에 한꺼번에 갱신합니다.
4.5 머리글 / 바닥글과 버전 번호를 페이지마다 직접 치지 않는다
나쁜 패턴
문서명, 버전, 페이지 번호를 각 페이지에 직접 입력한다.
타이틀 페이지만 따로 다루고 싶어 보이는 모습을 손으로 조정한다.
무엇이 괴로운가
버전 갱신을 잊거나, 페이지 번호가 어긋나거나, 도중부터 부록만 서식을 바꾸고 싶을 때 무너지는 문제가 납니다.
베스트 프랙티스
문서명, 버전, 페이지 번호는 머리글 / 바닥글에 모읍니다.
타이틀 페이지만 따로 하고 싶다면 첫 페이지 다르게 지정, 장이나 부록별로 바꾸고 싶다면 섹션 구분과 이전과 같은 머리글 / 바닥글 해제를 씁니다.
4.6 변경 이력·댓글·그림표를 나눈다
나쁜 패턴
빨간 글씨로 「여기 고침」, 「미확인」, 「상의 필요」라고 써 두고, 그대로 최종판에도 섞어 둔다.
화면 전체 스크린샷을 붙이기만 하고, 그림 번호도 설명도 없다.
무엇이 괴로운가
어느 것이 본문이고, 어느 것이 리뷰 중인 메모인지 알 수 없게 됩니다.
최종판에 리뷰 흔적이 남는 원인도 됩니다.
베스트 프랙티스
수정 자체는 변경 내용 추적, 상의나 지시는 댓글로 나눕니다.
그림이나 표에는 캡션을 붙이고, 필요에 따라 대체 텍스트도 설정합니다.
5. 매뉴얼용 Word 템플릿의 최소한
갑자기 공들인 템플릿은 필요 없습니다.
처음에는 다음 정도면 충분합니다.
| 요소 | 용도 | 최소한의 규칙 |
|---|---|---|
| 문서 타이틀 | 표지·서두 타이틀 | 문서명, 버전, 작성일, 개정일을 둔다 |
제목 1 |
장 | 자동 목차 대상 |
제목 2 |
절 | 자동 목차 대상 |
제목 3 |
소제목 | 필요할 때만 쓴다 |
표준 |
본문 | 기본문 |
| 번호 매기기 | 절차 | 조작 절차에 쓴다 |
| 글머리 기호 | 보충 | 조건이나 주의의 열거에 쓴다 |
| 그림 캡션 | 그림 번호 | 그림 1, 그림 2… |
| 표 캡션 | 표 번호 | 표 1, 표 2… |
| 머리글 / 바닥글 | 공통 정보 | 문서명, 버전, 페이지 번호 |
또한, 운용 규칙으로 다음을 정해두면 꽤 편해집니다.
- 원본은
.docx - 배포는 PDF
- 개정 시에는 변경 내용 추적을 쓴다
- 배포 전에 필드 갱신
- 배포 전에 접근성 검사
6. 배포 전 체크
매뉴얼을 PDF로 만들기 전, 최소한 여기는 보고 싶습니다.
6.1 전체 필드 갱신
Ctrl + A로 전체 선택하고 필드를 갱신합니다.
목차, 페이지 번호, 상호 참조, 그림·표 번호의 갱신 누락을 줄일 수 있습니다.
6.2 변경 이력과 댓글 정리
리뷰 도중의 이력이나 댓글이 남아 있지 않은지 확인합니다.
「숨겼을 뿐」으로 남아 있는 경우가 있으니 주의합니다.
6.3 제목 레벨 확인
장 구성이 제목 1 / 2 / 3으로 갖추어져 있는지 봅니다.
여기가 맞지 않으면 목차와 탐색이 무너집니다.
6.4 이미지와 표의 확인
그림표에 번호가 있는지, 이미지가 너무 크지 않은지, 무엇을 보면 되는지 본문에서 설명할 수 있는지를 확인합니다.
6.5 접근성 검사
접근성 검사를 실행하여 제목, 대체 텍스트, 대비, 표 구조 등에 문제가 없는지 확인합니다.
PDF 배포를 전제로 한다면 Word 쪽에서 먼저 다듬어 두는 편이 안전합니다.
7. 정리
Word로 매뉴얼을 만들 때 가장 피하고 싶은 것은 구조까지 수작업으로 담는 것입니다.
- 제목은 스타일
- 절차는 번호 기능
- 목차는 자동
- 페이지 제어는 페이지 나누기와 섹션
- 그림표는 캡션
- 리뷰는 변경 내용 추적과 댓글
- 참조는 상호 참조
- 배포 전에 갱신과 체크
요컨대, Word를 「글자를 치는 도구」만으로 끝내지 말고, 문서 구조를 관리하는 도구로 쓰는 것이 중요합니다.
매뉴얼은 쓴 순간보다 고치는 순간에 차이가 납니다.
개정할 때마다 무너지는 문서는 내용 이전에 Word의 기본 규칙이 무너져 있는 경우가 많습니다.
반대로 말하면, 여기를 짚기만 해도 문서의 유지보수성은 상당히 올라갑니다.
처음부터 공들인 디자인을 목표로 할 필요는 없습니다.
우선은 제목·번호·목차·페이지 나누기·리뷰 5가지를 수작업에서 떼어내는 것부터 시작하는 것이 실무적입니다.
관련 기사
같은 태그를 공유하는 최신 기사입니다. 더 가까운 주제로 지식을 넓힐 수 있습니다.
Word 매뉴얼 작성 응용편 - 이미지・그림・스크린샷 배치의 나쁜 패턴과 베스트 프랙티스
Word 매뉴얼에서 이미지・그림・스크린샷의 배치를 무너뜨리지 않는 노하우를 나쁜 패턴과 베스트 프랙티스로 정리합니다. 인라인 기본, 첫 언급 직후 배치, 캡션 자동 채번, 상호 참조, 트리밍 영역 삭제, 대체 텍스트까지 운용 규칙으로 고정해 개정...
Windows의 문자 코드와 개행 코드를 정리한다 - Shift_JIS / UTF-8 / UTF-16, 문자 깨짐, CRLF / LF, 왜 혼란스러운가
Windows에서 자주 섞이는 Shift_JIS와 UTF-8, UTF-16, BOM, CRLF/LF의 차이를 bytes 시점에서 분해하고, 문자 깨짐과 개행 문제를 나누어 다루는 실무 규칙과 사고 조사의 5문 체크리스트까지 정리했습니다.
의사난수와 진짜 난수의 차이란 - 어떻게 구별하는지 정리
의사난수와 진짜 난수(NRBG)를 구별하는 핵심을 정리합니다. 출력의 겉모습이 아니라 생성기 구성, seed, reseed, health test로 봐야 한다는 점과 보안 용도에서는 OS의 secure RNG와 CSPRNG가 본진임을 짧게 설명합니다.
GS1 등 바코드 규격에서 무엇이 정해져 있고, 실운용에서 무엇에 주의해야 하는가 - GTIN · AI · GS1-128 · GS1 DataMatrix의 정리
GTIN・AI・GS1-128・GS1 DataMatrix・GS1 QR 코드의 차이를 정리하고, 식별 키, 속성, 심볼, 스캐너 출력, 상품 마스터 운용까지 분리해 설계하는 실무 포인트와 도입 순서를 정리합니다.
COM 컴포넌트나 OCX / ActiveX 개발에서 빠지기 쉬운 것 - Visual Studio의 32bit / 64bit, 등록, 관리자 권한의 덫을 정리
COM 컴포넌트와 ActiveX, OCX 개발에서 자주 만나는 0x80040154나 0x80070005를 비트 수, 등록 방식, HKCU와 HKLM 스코프, 관리자 권한이라는 네 축으로 풀어 Visual Studio 2022의 64bit화 시대에...
관련 토픽
이 기사와 가까운 토픽 페이지입니다. 기사를 출발점 삼아 관련 서비스와 다른 기사로 이어집니다.
Windows 기술 토픽
Windows 개발, 장애 조사, 기존 자산 활용에 관한 KomuraSoft LLC 기사를 모은 토픽 허브입니다.
저자 프로필
기사 저자의 프로필 페이지입니다.
Go Komura
합동회사 코무라소프트 대표
Windows 소프트웨어 개발, 기술 상담, 장애 조사를 중심으로 재현이 어려운 장애 조사와 기존 자산이 남아 있는 프로젝트에 강점이 있습니다.
공개 링크