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 도구에서 바꿀 수 있습니다. 장 아이디와 새 제목을 함께 전달합니다.
다음 장의 제목을 "설치 준비"로 바꿔줘. [장 아이디]
문서 아이디를 먼저 전달해 장 차례를 파악하게 했다면 장 아이디 대신 제목으로 지칭할 수도 있습니다.
시스템 요구 사항 장의 제목을 "설치 준비"로 바꿔줘.
장 속성 바꾸기
장의 부제목, 저자, 주제도 AI 도구에서 바꿀 수 있습니다. AI 도구가 장을 읽으면 장 제목과 함께 지금 값을 확인합니다.
다음 장의 부제목을 "설치 전에 확인할 사항"으로 바꿔줘. [장 아이디]
전달한 속성만 바꾸고 나머지 속성은 그대로 둡니다.
빈 값을 전달하면 그 속성을 지웁니다.
장 제목은 앞에서 설명한 방법으로 따로 바꿉니다.
문서를 번역할 때 본문과 장 제목뿐 아니라 부제목, 저자, 주제도 함께 옮기도록 요청할 수 있습니다.
매뉴얼웍스 6.0.26 버전부터 지원합니다.
장 만들기
책 문서에 새 장을 만들 수 있습니다. 문서 아이디와 장 제목을 함께 전달합니다.
다음 문서에 "문제 해결" 장을 만들어줘. [문서 아이디]
특정 장 다음에 넣으려면 기준이 되는 장을 함께 전달합니다.
"설치 준비" 장 다음에 "설치하기" 장을 만들어줘.
위치를 정하지 않으면 화면에서 장을 만들 때처럼 유형에 맞는 자리에 넣습니다. 예를 들어 본문 장은 찾아보기 같은 뒷부분 장 앞에, 부록은 부록의 맨 끝에 넣습니다.
장 유형을 정하지 않으면 본문 장으로 만듭니다.
매뉴얼웍스 6.0.26 버전부터 지원합니다.
장 만들기, 장 유형 바꾸기, 장 순서 바꾸기는 책 문서에서만 할 수 있으며, 화면에서와 같이 문서 소유자만 할 수 있습니다. 세 작업 모두 바뀐 뒤의 장 목록을 돌려주므로 AI 도구가 결과를 바로 확인합니다.
장 유형 바꾸기
장 유형도 AI 도구에서 바꿀 수 있습니다. 장 아이디와 바꿀 유형을 함께 전달합니다.
다음 장을 부록으로 바꿔줘. [장 아이디]
장 변경 화면에서 고를 수 있는 유형으로만 바꿀 수 있습니다.
장의 위치는 그대로 둡니다. 유형에 맞는 자리로 옮기려면 장 순서를 따로 바꿉니다.
매뉴얼웍스 6.0.26 버전부터 지원합니다.
장 순서 바꾸기
같은 문서 안에서 장의 순서를 바꿀 수 있습니다. 옮길 장과 기준이 되는 장을 함께 전달합니다.
"문제 해결" 장을 "설치하기" 장 앞으로 옮겨줘.
기준이 되는 장의 앞이나 뒤로 옮깁니다.
다른 문서로는 옮길 수 없습니다.
매뉴얼웍스 6.0.26 버전부터 지원합니다.
단락 유형 바꾸기
단락 유형도 AI 도구에서 바꿀 수 있습니다. 단락 아이디와 바꿀 유형을 함께 전달합니다. 유형은 에디터에 나오는 이름을 그대로 씁니다.
다음 단락을 노트로 바꿔줘. [단락 아이디]
서로 붙어 있는 여러 단락을 한 번에 바꿀 수 있습니다.
코드나 노트처럼 줄 바꿈을 허용하는 유형으로 바꾸면 선택한 단락을 하나로 합칩니다. 보통이나 제목처럼 허용하지 않는 유형으로 바꾸면 줄 단위로 나눕니다. 에디터에서 바꿀 때와 같습니다.
본문에 쓰는 유형으로만 바꿀 수 있습니다. 장 제목이나 부 제목 같은 유형으로는 바꿀 수 없습니다.
단락 옵션 바꾸기
별칭과 내보내기 제외, 그림의 대체 텍스트, 코드 단락의 언어를 AI 도구에서 바꿀 수 있습니다.
다음 단락을 PDF에서 제외해줘. [단락 아이디]
전달한 옵션만 바꾸고 나머지 옵션은 그대로 둡니다.
대체 텍스트는 그림 단락에만, 코드 언어는 코드와 표 단락에만 줄 수 있습니다.
별칭은 문서 안에서 유일해야 합니다.
내보내기 제외는 웹과 PDF, 임베딩(RAG) 중에서 고릅니다.
그림 넣기
AI 도구에서 그림 파일을 그림 단락으로 넣을 수 있습니다. AI 도구가 업로드 주소를 받아 파일을 그대로 올린 뒤 그림 단락을 만듭니다.
이 그림을 다음 단락 뒤에 넣어줘. [단락 아이디] [파일 경로]
PNG, JPEG, GIF 파일만 올릴 수 있고, 크기는 20MB까지입니다.
HTTP 요청을 보낼 수 없는 AI 도구는 그림을 base64 문자열로 넣습니다. 그림이 크면 문자열을 옮기다 틀려 실패할 수 있습니다.
변경 내용 확인
AI 도구가 내용을 변경하면 매뉴얼웍스 에디터에서 실시간으로 바뀐 내용을 확인할 수 있습니다. 1을 클릭하면 해당 단락으로 이동합니다. 2를 클릭하면 단락 단위로 바뀐 내용을 보여줍니다.
이력 비교로도 확인할 수 있습니다. AI 도구로 변경했을 때는 3사용자 아이디에 @mcp를 붙여 표시합니다. AI 도구 설정에 X-MCP-Client 헤더를 넣으면 @claude-code처럼 도구 이름을 붙입니다. 자세한 사항은 작업한 AI 도구 이름 남기기를 참고합니다.
팁
대화로 AI 동작 조정하기
AI 모델마다 동작 방식이 다릅니다. 대화를 통해 조금씩 조정해 나가야 합니다. 어떤 AI는 확인 없이 바로 교정을 반영하기도 합니다. 이때는 확인 후 업데이트하도록 요청합니다.
내용을 바로 업데이트하지 말고 확인 과정을 거치자.
실수를 하기도 합니다. 이때는 다시 작업하게 하면 됩니다.
Windows를 윈도우로 임의로 변경했네. 다시 되돌리자.
절만 읽기
장 내용이 길면 절만 읽어서 작업을 할 수 있습니다. 제목 단락의 아이디를 주면서 절을 읽도록 합니다.
이 절 내용 읽어봐. [제목 단락 아이디]
토큰 사용량을 절약하는 데 도움이 됩니다.
전체 문서 읽기
문서 아이디를 전달하면 장 차례를 파악하게 할 수 있습니다.
다음 문서를 읽어봐. [문서 아이디]
이후에는 장 아이디가 아닌 장 제목으로 대화를 할 수도 있습니다.
시스템 요구 사항 장을 교정해봐.
많은 장이 있는 문서 교정을 다음과 같이 할 수도 있습니다.
전체 장을 순차적으로 읽고 교정해. 바로 업데이트해.
찾아보기(색인) 작업도 가능합니다.
전체 문서의 찾아보기(색인) 설정을 해줘.
웹 뷰어에서 숨긴 장은 AI 도구에게 숨긴 장(hidden)으로 알려줍니다. 독자에게 보이지 않는 장은 공개하지 않은 기능이나 작성 중인 내용을 담을 수 있으므로, AI 도구가 공개된 내용과 구분해서 판단합니다. 매뉴얼웍스 6.0.26 버전부터 지원합니다.
새 세션 시작 루틴
새 세션을 열 때마다 다음 순서로 시작하면 일관된 결과를 얻을 수 있습니다.
매뉴얼웍스 문서 형식(
get_style_guide) 로드문서 작성 스타일 가이드 전달
문서 아이디 전달
매번 같은 순서로 시작하는 습관을 들이면 설정 누락으로 인한 오류를 줄일 수 있습니다.
작업 단위 쪼개기
한 번에 많은 양을 작업시키면 누락이나 오류가 생기기 쉽습니다. 장 단위 또는 절 단위로 나눠서 요청하는 것을 권장합니다.
이 절만 먼저 교정해줘. [제목 단락 아이디]
결과를 확인한 후 다음 절로 넘어가는 방식으로 진행합니다.
같은 내용 반복 강조
AI가 대화 중에 이전 지시를 잊거나 무시할 때는 규칙을 다시 상기시킵니다.
HTML 태그는 수정하지 않기로 했지. 꼭 지켜줘.
현재 지원하지 않는 작업
장을 삭제할 수 없습니다.
장을 다른 문서로 옮길 수 없습니다.