Claude Code, Codex, Gemini CLI(이하 AI 도구)에서 장과 단락을 기반으로 문서를 작성하는 방법을 설명합니다.
장과 단락 아이디 확인
기본적으로 AI 도구와의 작업은 장 또는 단락 아이디를 전달하는 것으로 시작합니다. 다음처럼 1장 아이디를 전달해서 장 내용을 확인합니다.
API 키를 만든 사용자가 편집할 수 있는 문서에만 접근할 수 있습니다.
이를 위해 매뉴얼웍스 에디터에서 장과 단락 아이디를 확인하는 방법을 제공합니다. 장 아이디는 에디터 상단 도구에서 1설정 아이콘을 클릭한 후 2복사합니다.
단락 아이디는 단락 하단에 있는 3아이콘을 클릭한 후 4복사합니다.
문서 작업하기
기본적으로 AI 도구를 통해 장 단위로 글을 작성하거나 기존에 작성한 내용을 교정할 수 있습니다. 그리고 다음 작업도 할 수 있습니다.
특정 단어를 바꾸기
찾아보기 설정
매우 강조 설정
표 단락 행을 이름에 따라 정렬하거나 열 순서를 바꾸기
여러 장의 용어와 서술 방법 통일하기
여러 장의 내용을 합치기
할 수 있는 작업과 완성도는 AI 모델에 따라 다를 수 있습니다.
가이드 전달하기
AI 도구에게 다음과 같이 매뉴얼웍스의 문서 형식을 읽도록 요청합니다.
매뉴얼웍스의 스타일 가이드를 확인해서, 앞으로 문서 작업을 할 때 참고 부탁해
그리고 AI 도구에게 미리 문서 작성 스타일 가이드를 전달하는 것을 권장합니다. 스타일 가이드를 매뉴얼웍스로 작성한 후 웹 뷰어에서 마크다운으로 복사해서 전달합니다. 다음은 쓰리래빗츠의 문서 작성 가이드입니다.
교정 요청
AI 도구에서 다음과 같이 요청합니다.
다음 장을 교정해줘. [장 아이디]
AI 도구에 따라 바로 반영하기도 합니다. 따라서 필요하다면 명시적으로 다음과 같이 요청할 수도 있습니다.
반영 전에 나에게 확인을 요청해줘
AI 도구가 장 내용을 읽고 수정이 필요한 부분을 안내합니다. 필요하다면 표로 요청할 수도 있습니다.
수정 반영
교정 내용을 확인한 후 수정을 원하면 다음과 같이 요청합니다.
수정해줘.
여러 단락을 한꺼번에 수정하거나 특정 단락만 수정하도록 요청할 수도 있습니다.
3번과 5번만 수정해줘.
단락 아이디를 전달해서 해당 단락에 대해서만 수정 요청을 할 수도 있습니다.
내용 추가
AI 도구에서 장에 새로운 내용을 추가하는 방법을 설명합니다. 먼저 AI와의 대화를 통해 작성할 내용을 정리합니다. 내용은 마크다운 형식으로 작성합니다.
AI에게 추가할 내용을 마크다운 형식으로 작성하도록 요청합니다. 제목, 목록, 강조, 링크 등을 사용할 수 있습니다.
추가 위치 확인
에디터에서 단락 옵션을 클릭해서 새 내용을 넣을 단락의 아이디를 확인합니다.
추가 요청
AI를 이용해서 내용을 구성하고 작성합니다. 작성이 끝났으면 다음 대화를 통해 매뉴얼웍스에 반영합니다.
AI 도구에서 다음과 같이 요청합니다. 특정 단락을 기준으로 앞에 작성할지, 뒤에 작성할지를 결정합니다.
다음 단락 다음에 A를 주제로 내용을 작성해서 추가해줘. [단락 아이디] [추가할 내용]
다음 단락 앞에 정리한 내용을 추가해줘. [단락 아이디] [추가할 내용]
또는 장 아이디를 전달해서 해당 장에 작성해달라고 할 수도 있습니다.
다음 장에 지금까지 작성한 내용을 추가해줘. [장 아이디]
추가한 내용을 기반으로 반복적으로 수정 작업을 할 수 있습니다. 자동으로 AI 도구가 새로 만든 단락 아이디를 파악하기 때문에 별도 요청 없이 자연어로 수정 작업을 할 수 있습니다.
변경 내용 확인
AI 도구가 내용을 변경하면 매뉴얼웍스 에디터에서 실시간으로 바뀐 내용을 확인할 수 있습니다. 1을 클릭하면 해당 단락으로 이동합니다. 2를 클릭하면 단락 단위로 바뀐 내용을 보여줍니다.
이력 비교로도 확인할 수 있습니다. AI 도구로 변경했을 때는 3사용자 아이디에 @mcp를 붙여 표시합니다.
팁
대화로 AI 동작 조정하기
AI 모델마다 동작 방식이 다릅니다. 대화를 통해 조금씩 조정해 나가야 합니다. 어떤 AI는 확인 없이 바로 교정을 반영하기도 합니다. 이때는 확인 후 업데이트하도록 요청합니다.
내용을 바로 업데이트하지 말고 확인 과정을 거치자.
실수를 하기도 합니다. 이때는 다시 작업하게 하면 됩니다.
Windows를 윈도우로 임의로 변경했네. 다시 되돌리자.
절만 읽기
장 내용이 길면 절만 읽어서 작업을 할 수 있습니다. 제목 단락의 아이디를 주면서 절을 읽도록 합니다.
이 절 내용 읽어봐. [제목 단락 아이디]
토큰 사용량을 절약하는 데 도움이 됩니다.
전체 문서 읽기
문서 아이디를 전달하면 장 차례를 파악하게 할 수 있습니다.
다음 문서를 읽어봐. [문서 아이디]
이후에는 장 아이디가 아닌 장 제목으로 대화를 할 수도 있습니다.
시스템 요구 사항 장을 교정해봐.
많은 장이 있는 문서 교정을 다음과 같이 할 수도 있습니다.
전체 장을 순차적으로 읽고 교정해. 바로 업데이트해.
찾아보기(색인) 작업도 가능합니다.
전체 문서의 찾아보기(색인) 설정을 해줘.
새 세션 시작 루틴
새 세션을 열 때마다 다음 순서로 시작하면 일관된 결과를 얻을 수 있습니다.
매뉴얼웍스 문서 형식(
get_style_guide) 로드문서 작성 스타일 가이드 전달
문서 아이디 전달
매번 같은 순서로 시작하는 습관을 들이면 설정 누락으로 인한 오류를 줄일 수 있습니다.
작업 단위 쪼개기
한 번에 많은 양을 작업시키면 누락이나 오류가 생기기 쉽습니다. 장 단위 또는 절 단위로 나눠서 요청하는 것을 권장합니다.
이 절만 먼저 교정해줘. [제목 단락 아이디]
결과를 확인한 후 다음 절로 넘어가는 방식으로 진행합니다.
같은 내용 반복 강조
AI가 대화 중에 이전 지시를 잊거나 무시할 때는 규칙을 다시 상기시킵니다.
HTML 태그는 수정하지 않기로 했지. 꼭 지켜줘.
현재 지원하지 않는 작업
장을 삭제할 수 없습니다.
단락 유형을 바꾸거나 옵션을 설정할 수 없습니다.