
關於 GitBook
What Is GitBook
GitBook 是架設與代管產品文件的網頁平台。團隊用支援 Markdown 的區塊編輯器撰寫內容,透過 GitHub 或 GitLab 同步,再發布成帶有自家品牌的文件網站,內建搜尋、數據分析與嵌入式 AI 助理。它鎖定的對象,是維護 API 參考、客服中心與內部知識庫的人。
它解決的是文件四散、內容過期的老問題。撰寫、審閱與發布通常分散在三套工具裡,更新永遠落後於產品。GitBook 把整段流程收在一處,並加上一個 AI 代理,能依客服單與產品更新草擬修改,還有雙向的 Git Sync,讓工程師在自己慣用的編輯器改 Markdown,寫手則在視覺化編輯器裡作業。
它的限制主要在價格與流程綁定。免費版只給一位使用者,協作與幾乎所有 AI 功能都落在付費方案,最低每月每站 65 美元,另加每位使用者 12 美元。網站外觀的細部控制也比親手打造的網站來得窄,設計需求特殊的品牌很快就會碰到天花板。
Getting Started
- 用 GitHub、Google 或電子郵件在 GitBook 官網註冊,建立你的第一個 space。
- 直接撰寫內容,或從 Markdown、Confluence、Notion、Google Docs 匯入,兩種方式都能在區塊編輯器裡進行。
- 想用 Git Sync 就先接上 GitHub 或 GitLab 儲存庫,接著邀請團隊成員,開一張變更請求來審閱修改。
- 把 space 發布成文件網站,在付費方案加上自訂網域,需要時再開啟 AI 助理。
產品資訊
快速了解 GitBook 的定價、支援平台與效能。
適合對象
這項工具最適合的使用者、任務與情境。
使用者
- 技術寫手:在一處撰寫與審閱長篇 API 參考與指南,享有變更請求與版本紀錄,前提是團隊有付費席次。
- 軟體工程師:在自己慣用的編輯器寫文件,再透過 Git Sync 推上去,文件因此留在每天用得到的流程裡。
- 客服與產品團隊:靠 AI 代理把客服單與版本說明變成文件更新,讓不專職寫作的人也能一起維護內容。
任務
- 發布文件網站:用這套文件網站架設工具,做出帶品牌、可搜尋的知識庫並掛上自訂網域,SEO、sitemap 與全文搜尋都已經處理好。
- 撰寫 API 文件:這款 API 文件工具能匯入 OpenAPI 或 Swagger 規格,生成互動式參考,規格一改就自動更新,還附上測試端點的 playground。
- 將文件在地化:用 AI 把內容轉成多種語言,原始頁面一改,譯文就跟著重新同步。
情境
- 讓 API 文件跟上每次改版:參考是從規格生成、再與 Git 同步,新端點出現時不必手動重寫。
- 建立內部知識庫:用區塊與群組把多個產品收在同一個網站,驗證存取則把機密頁面擋在公開範圍之外。
- 大規模回覆使用者問題:嵌入式 AI 助理依你的文件與已連接的來源作答,常見問題的重複客服單因此變少。
主要功能
區塊式視覺化編輯器
編輯器像文件工具,採用所見即所得的區塊,並完整支援 Markdown,寫手拖曳內容的同時,工程師可以在同一個 space 直接敲原始語法。即時協作讓多人同時編輯,留言也能掛在特定區塊上。技術與非技術成員因此共用同一套流程,不必再互傳檔案。
Git Sync
雙向同步把 GitBook 接上 GitHub 或 GitLab 儲存庫。在視覺化編輯器改的內容會更新儲存庫,推上儲存庫的 Markdown 也會更新 GitBook,兩邊始終一致。分支、審閱與合併比照寫程式的做法,工程團隊因此願意在這裡寫文件,而不是另外開一套工具。
為 AI 準備好的文件
發布後的文件會自動生成 MCP 伺服器,以及 llms.txt 與 Markdown 版本,AI 工具與程式代理都能讀取你的內容。WebMCP 支援讓瀏覽器裡的代理搜尋文件並取回頁面。這裡沒有東西需要設定,如果你希望產品出現在 AI 回答裡,這點格外關鍵。
GitBook Agent 與 Assistant
GitBook Agent 負責撰寫與修改文件,依客服單與產品更新提出變更,再交由真人審閱。Assistant 則是用戶端看得到的部分:一位嵌入式產品專家,依你的文件與已連接的來源回答問題。它把靜態網站變成使用者可以直接提問的對象。
會自動更新的 API 文件
匯入 OpenAPI 或 Swagger 定義後,GitBook 會生成結構化參考,含端點、參數與可直接複製的範例。規格一變,參考就自己更新,頁面上的互動 playground 還讓開發者直接測試呼叫。
一鍵完成在地化
翻譯功能用 AI 把內容轉成多種語言,原始內容一改,譯文就重新同步,英文頁面改過不會讓其他語言放著爛。方案層級較高時,用量直接內含而非按字計費,適合要在多個市場發布內容的團隊。
給團隊用的知識庫軟體
GitBook 網站同時也是一套知識庫軟體,不只是對外的公開手冊。區塊與群組收納多個產品,版本紀錄留下誰改了什麼,驗證存取則把機密頁面藏起來。客服、產品與工程團隊最後都在同一處讀與寫。
內容品質工具
內容缺口、失效連結、共用風格指南與搜尋分析集中在一處。Agent 會補上它找到的缺口,風格指南則讓所有人維持一致,不管草稿是人寫的還是 AI 擬的。這一層的用途,是避免大型文件網站無聲無息地爛掉。
數據分析、搜尋與存取控制
頁面瀏覽數據、全文搜尋與使用者回饋,讓你看出哪些內容被讀、哪些地方卡住。方案層級較高時,驗證存取與動態內容會依檢視者身分顯示或隱藏頁面,對於公私內容混在同一站的情況格外重要。
優缺點
優點
- 撰寫、審閱與發布集中在同一處:變更請求、版本紀錄與留言取代了三套工具來回切換的老問題。
- Git Sync 配合每個人的習慣:工程師在 IDE 改 Markdown,寫手用視覺化編輯器,兩邊始終同步。
- AI 功能直接內建:MCP 伺服器、LLM 最佳化與 AI 代理都是標配,文件不必額外設定就能給 AI 工具讀。
- 起步快:從 Markdown、Confluence、Notion 或 Google Docs 匯入,一場作業時間就能發布帶品牌、可搜尋的網站。
缺點
- 免費版偏薄:只涵蓋一位使用者,團隊只要需要協作、自訂網域或助理,就得轉往付費方案。
- 按站計價會累積:Essential 每月每站 65 美元,另加每位使用者 12 美元,組織手上有多個網站時開銷可觀。
- 設計控制有限:可調整的只有標誌、字型與顏色,稱不上完整的網站架設工具,遇到特殊版面得自己想辦法繞。
常見問題
GitBook 用來撰寫、審閱與發布產品文件。團隊用它建立文件網站、API 參考與內部知識庫,付費方案還能在內容之上加上 AI 助理與代理。
相關內容
探索與 GitBook 相關的工具、技能與文章。
GitBook 替代方案
Base Code
Base44 (Wix) · 程式設計 · 生產力Base Code 是 Base44 推出的共享雲端開發環境。團隊在對話中描述對既有 GitHub 儲存庫的修改,看著預覽確認結果,再以 Pull Request 交回工程團隊。
Knocket
Knocket (Tencent RTC team) · 生產力 · 商業 · 聊天機器人Knocket 是免費的線上客服與聯絡頁面工具,訪客可從網站、App 或一條分享連結傳訊息,你在 Telegram 或單一收件匣就能回覆。
FloorGen
Vinit Kumar (FloorGen) · 生產力 · 中國 AIFloorGen 是瀏覽器上的平面圖製作工具,能把一句描述或一張草圖變成可編輯的 2D 平面圖與 3D 導覽。可匯出 PDF、DXF 或影片,不註冊也能開始畫。
