创建 Wiki 应用
适用读者:需要搭建产品文档、帮助中心、内部 Wiki 的运营或文档工程师
前置条件:已登录组织工作台;建议已有一个知识库空间(可在向导中新建)
预计耗时:约 15 分钟
概述
Wiki 类应用负责将 知识库 中的文档以文档站形式对外呈现。正文在知识库用 文档编辑器 撰写与协作;应用负责主题、导航、域名与 发布同步。这与 CMS 类「在应用后台直接写页面」的路径不同,也是新手最容易混淆的一点。
若尚未理解三库分工,请先读 创建应用。本篇以 Docs 模板为例演示 Wiki 应用创建与知识库绑定。
Wiki 与 CMS、Community 有何不同?
| 维度 | Wiki 类(本篇) | CMS 类 | Community 类 |
|---|---|---|---|
| 内容写在哪里 | 知识库 | 应用后台页面管理 | 应用后台 + 社区互动 |
| 创建向导关键步 | 选择数据源(知识库) | 无知识库步骤 | 通常无知识库步骤 |
| 发布方式 | 知识库保存 → 应用发布 同步 | 页面保存即生效(可配合版本发布) | 页面/话题发布 + 评论互动 |
| 代表模板 | Docs、Help、Developers、Chat | Blog、WWW、Events | Community、Feedback |
| 延伸阅读 | 发布到 Wiki 应用站点 | 创建 CMS 应用 | 创建 Community 应用 |
步骤一:进入应用市场并筛选 Wiki 模板

- 在 应用库 点击 通过模板创建,进入应用市场。
- 点击顶部分类 Wiki,仅显示 Wiki 类模板。
- 常见选型:
- Docs:产品手册、技术文档
- Help:帮助中心、FAQ
- Developers:开发者文档、SDK 说明
- Chat:接入 AI 问答的文档站
- 悬停于 Docs(或目标模板),点击 安装。
预期结果:进入创建向导,且第一步会出现 数据源(知识库) 区域。
步骤二:绑定知识库并完成向导

- 第一步 — 模板:确认 Docs(或所选 Wiki 模板)与版本策略。
- 数据源(知识库):点击 点击选择:
- 选择已有知识库;或
- 在弹窗中 新建知识库(见 创建与管理知识库空间)。
- 第二步 / 第三步:填写应用名称、访问域名等,逐步 下一步 至 完成。
💡
提示:同一知识库可绑定多个 Wiki 应用(如中文站 + 英文站)。创建时选好数据源,后续亦可在应用 基本设置 中调整(见 应用基本设置)。
预期结果:应用库出现新 Wiki 应用卡片;知识库与应用已建立数据源关系。
步骤三:在知识库撰写并发布到 Wiki
- 打开左侧 知识库,进入已绑定的空间。
- 使用 文档编辑器撰写文档(见 文档编辑器)。
- 保存后,进入知识库 发布 页,对目标 Wiki 应用执行 立即同步(见 发布到 Wiki 应用站点)。
预期结果:前台 Wiki 站点可访问最新文档;应用库卡片 前台访问 可预览。
步骤四:认识应用卡片操作

| 按钮 | 作用 |
|---|---|
| 后台管理 | 配置主题、域名、权限等(非撰写正文的主路径) |
| 前台访问 | 打开对外 Wiki 站点预览 |
Wiki 日常写作仍以 知识库 为主;应用后台用于站点级配置,见 栏目与页面 中与 Wiki 模板相关的导航说明。
预期结果:明确「知识库写、Wiki 应用看」的分工。
常见问题
Q:创建时忘记绑定知识库怎么办?
A:进入该应用 后台管理 → 基本设置,重新指定内容来源知识库,然后在知识库 发布 页同步。
A:进入该应用 后台管理 → 基本设置,重新指定内容来源知识库,然后在知识库 发布 页同步。
Q:Wiki 应用里找不到页面编辑器?
A:Wiki 正文在知识库;应用后台主要是站点设置与部分模板定义的静态页,属正常现象。
A:Wiki 正文在知识库;应用后台主要是站点设置与部分模板定义的静态页,属正常现象。
相关阅读
- 创建应用 — CMS / Wiki 内容路径对比
- 创建与管理知识库空间 — 新建知识库
- 文档编辑器 — 撰写与保存
- 发布到 Wiki 应用站点 — 同步到前台
- 创建您的第一个应用 — 应用库通用创建流程
- Docs — Docs 深度说明