GitBook

편집기는 문서 도구처럼 움직이고, WYSIWYG 블록과 Markdown 완전 지원을 갖춘다. 라이터가 내용을 옮기는 동안 개발자가 같은 스페이스에서 원시 문법을 친다. 실시간 공동 편집으로 여러 명이 동시에 손대고, 댓글은 특정 블록에 붙는다. 기술자와 비기술자가 파일을 주고받는 대신 같은 흐름을 공유하게 만드는 부품이다.

양방향 동기화가 GitBook과 GitHub나 GitLab 저장소를 잇는다. 비주얼 편집기에서 고친 내용은 저장소에 반영되고, 저장소에 올린 Markdown은 GitBook에 반영된다. 양쪽이 늘 맞춰진 상태를 유지한다. 브랜치와 리뷰, 병합은 코드와 같은 방식으로 돈다. 엔지니어링 팀이 별도 도구 대신 여기서 쓰는 걸 받아들이는 이유다.

발행한 문서는 MCP 서버를 자동으로 만들고, llms.txt와 Markdown 버전도 준비한다. AI 도구와 코딩 에이전트가 내용을 읽을 수 있다. WebMCP 지원 덕분에 브라우저 위 에이전트도 문서를 검색하고 페이지를 가져온다. 여기서 설정할 것은 없다. 추가 작업 없이 자사 제품을 AI 답변에 띄우고 싶다면 이 점이 중요하다.

GitBook Agent는 문서를 쓰고 고치며, 지원 티켓과 제품 업데이트를 근거로 수정안을 낸다. 사람이 이를 검토한다. Assistant는 사용자 쪽에서 보이는 부분이다. 문서와 연결된 소스에서 답하는 임베드된 제품 전문가다. 정적인 사이트를 사용자가 직접 물어볼 수 있는 상대로 바꾼다.

OpenAPI나 Swagger 정의를 불러오면 GitBook이 엔드포인트와 파라미터, 복사 가능한 예제를 갖춘 구조화된 레퍼런스를 세운다. 명세가 바뀌면 레퍼런스는 스스로 갱신되고, 페이지 위 대화형 playground에서 개발자가 호출을 시험한다.

번역 기능은 AI로 내용을 여러 언어로 넓히고, 원본이 바뀌면 번역도 다시 맞춘다. 영어 페이지를 고쳐도 다른 언어가 방치되지 않는다. 상위 플랜에서는 사용량이 단어당 과금이 아니라 포함된다. 여러 시장에 발행하는 팀에 맞는다.

GitBook 사이트는 공개 매뉴얼만이 아니라 지식베이스 소프트웨어로도 일한다. 섹션과 그룹이 여러 제품을 담고, 버전 기록이 누가 무엇을 바꿨는지 남기며, 인증 접근이 사내 페이지를 감춘다. 지원과 제품, 엔지니어링이 결국 같은 곳에서 읽고 쓴다.

콘텐츠 빈틈과 끊긴 링크, 공유 스타일 가이드, 검색 분석이 한곳에 모인다. Agent는 찾아낸 빈틈을 채우고, 스타일 가이드는 사람이 썼든 AI가 초안을 잡았든 모두를 같은 기준에 맞춘다. 큰 문서 사이트가 조용히 망가지는 걸 막는 층이다.

페이지뷰 분석과 전문 검색, 사용자 피드백을 보면 어디가 읽히고 어디서 막히는지 알 수 있다. 상위 플랜에서는 인증 접근과 적응형 콘텐츠가 보는 사람에 따라 페이지를 보여주거나 감춘다. 공개와 사내 내용을 한 사이트에 섞을 때 중요하다.