AI指南

本文旨在提供 BWiki 编辑场景下的初级 AI 使用指南，持续更新中。请注意，本文不是通用的AI指南。

在合理引导下，AI 可以成为 Wiki 建设的有力助手。在 BWiki，AI 已广泛参与排版、润色和代码编写工作。

目前先进模型的能力已经非常强大，限制 AI 发挥的，往往是使用者的认知、表述和投入。

当然，AI 不了解 BWiki 特性细节，也不熟悉 Wiki 编辑实战，这些必然需要使用者补充。向 AI 提供清晰的信息、需求和目标，是用好它的关键。许多"如何有效提问"的方法论，例如经典的《提问的智慧》，同样适用于和 AI 打交道。

任何模型都会有"幻觉"，可能输出有问题的回答。AI作为"人类能力放大器"，永远不能替代技术文档，自身充足的知识和经验是用好AI的前提。

模型推荐

多数模型都能轻松胜任简单问答，无需特别推荐。

推荐DeepSeek V4，用专家模式 + 深度思考，默认关闭搜索。

国产模型大多提供免费的网页版，新模型均可尝试。不过，社区踩坑应该避免使用的有：豆包、千问、元宝、文心一言（这些模型通常需要更多、更严厉、更精准的提示词才能达到相同效果）。

一些非国产的顶级模型也值得推荐，比如 Gemini、Claude 和 ChatGPT。但这些模型的免费额度极少，通常需要不菲的月费，仅推荐刚需且用量大的用户订阅。其中，社区对 Gemini 的 Web 能力评价较高，即设计和编写HTML、CSS，回答 Web 相关问题等。

无论使用哪个模型，均推荐选择其最强的型号，开启思考。仅在必要时开启搜索，并严格约束搜索范围和采信原则。

新模型

几乎每天都有新模型发布，它们可能更强，可以关注相关领域新闻。

OpenRouter 销量榜单是用户"用钱投票"的市场份额，在涉及编程、Agent的场景中很有代表性。

不过仍需注意：各模型擅长领域不同，编程或日常对话评分高，不代表它在 Wiki 编辑上同样出色。

提示词分享

提示词的核心是为AI提供信息，不应墨守成规。与某个模型多次交流，熟悉其"能力和秉性"后，通常可以用较少的提示词完成复杂任务。

本节提供的提示词主要在 DeepSeek 上测试，用于评测模型在wiki任务上的能力。

注意，实际使用中，不推荐用这种"一把梭"的提示词。推荐通过多轮对话向模型交代背景、要用的特性和功能（比如需要使用的函数/标签语法和输出效果）、需求和目标等等等等。之后再设计方案、多次细化迭代至满意，最后再完成任务。

这种"一把梭"提示词实际上是对模型综合能力的"压力测试"，对于下文中"模板:提示"这类简单需求，26年以来的国产模型几乎都能一次写出勉强能用的模板。

模板生成

提示词包含以下两个部分：

任务：详细描述你的需求
说明：预设的指导规则，用于引导AI生成能用、符合需求的模板

食用方法：

修改「任务」部分，以定义您想生成的模板内容，
调整「说明」部分，以精确控制AI的编写行为

常见问题：

语法错误：偶尔会遗漏括号}，或多个class拼接时没有正确留空格
使用markdown：某些模型要反复强调禁止使用markdown
v0.1虽然针对千问和豆包常出的Bug打了不少补丁，但其模型能力实在有限，不会自主处理边界情况，经常不遵循提示词要求。需要多轮调整才勉强可用。

模板生成提示词 v0.2

请你帮我编写一个[[模板:提示]]，用来在wiki正文中向用户给出各类信息提示。

# Wiki模板生成技术规范

## 一、整体结构
所有模板必须采用以下标准结构：
```wikitext
<includeonly>模板正文</includeonly><noinclude>
模板说明文档wikitext
</noinclude>
```

说明文档必须包含：介绍、参数说明、示例。

---

## 二、HTML编写规范

### 1. 空格处理
```wikitext
✅ 正确：<div {{#if:{{{id|}}}| id="{{{id}}}" }}>
❌ 错误：<div{{#if:{{{id|}}}| id="{{{id}}}"}}>  <!-- id前的空格会丢失 -->
```

解析器函数参数的前后空格会被trim，但为了可读性可以保留：
```wikitext
{{#if: {{{1|}}} | 处理代码 }}  <!-- 可以这样写，空格会被自动去掉 -->
```

### 2. 换行处理
- 使用`<div>`和`<span>`，避免使用`<details>`、`<summary>`等语义标签，可能不兼容
- 需要消除换行时可用HTML注释：`<!-- -->`
- `<includeonly>`标签本身会占位产生空行，必要时标签紧贴内容

---

## 三、CSS编写规范

### 0. 通用
- 使用BEM命名法：`.块`、`.块__元素`、`.块--修饰符`，需添加前缀来避免跟全局样式冲突。
- 注释要简洁清晰，写在CSS类名括号后。
- 禁止使用rem、禁止指定font-family

### 1. CSS注入方式（二选一）

**方式A：使用`<bstyle>`（推荐）**
```wikitext
<bstyle>/*<pre>*/
.类名 {
    属性: 值;
}
/*</pre>*/</bstyle>
```
必须用`/*<pre>*/`包裹，防止Wiki解析器破坏CSS代码。

**方式B：使用`{{#css:}}`**
```wikitext
{{#css:
.类名 {
    属性: 值;
}
}}
```
注意`#css:`有安全过滤，会拦截含`url(`、`filter`等关键字的代码。参数**不能以注释开头**，否则会被识别为CSS文件路径触发外链加载；注释写在CSS内容后面没有问题。

### 2. CSS去重（必须实现）
同一页面多次调用模板时，必须防止CSS重复注入：

```wikitext
{{#if:{{#varexists:模板名CSS}} | | {{#vardefine:模板名CSS|1}}<bstyle>/*<pre>*/
/* 样式代码 */
/*</pre>*/</bstyle>}}
```
- 每个模板使用唯一的变量名，如`NoticeCSS`、`InfoboxCSS`
- 变量作用域为当前页面，不影响其他页面
- CSS去重块紧跟在模板HTML之后、`</includeonly>`之前，不单独换行，避免产生多余空白

---

## 四、参数处理规范

### 1. 参数设计原则
- **核心参数**用数字参数（`{{{1}}}`、`{{{2}}}`），**非核心参数**用命名参数
- 所有参数提供合理默认值：`{{{param|默认值}}}`
- 当参数用于接收可能包含列表、标题、表格、多行文本等wikitext内容时，必读独占一行。

### 2. 特殊字符转义

尽量避免在模板参数内嵌套wikitext表格，考虑用HTML `<table>` 替代。

**等号转义**：参数值中含等号时，用具名参数（位置参数`1=`）规避，不需要`{{=}}`
```wikitext
{{MyTemplate|1=含=号的内容}}
```

### 3. 空值判断
- 未传参时`{{{param|}}}`返回空字符串
- 可以用`#if`对空字符串判为假
- 需要避免生成冗余HTML时用`#if`包裹，不影响视觉时可省略
```wikitext
{{#if:{{{desc|}}}|<span class="desc">{{{desc}}}</span>}}
```

### 4. 接收wikitext内容的参数
参数在用于接收可能包含多行wikitext的内容时，参数值必须**独立占一行**，否则列表、标题等行首语法无法正常解析：
```wikitext
✗  <div class="...">{{{1|}}}</div>
✓  <div class="...">
{{{1|}}}
</div>
```

---

## 五、典型模板结构
完整示例如下
```wikitext
<includeonly><div class="my-template" {{#if:{{{id|}}}| id="{{{id}}}"}}>
<div class="my-template__header"><!--
--><span class="my-template__title">{{{title|默认标题}}}</span><!--
-->{{#if:{{{sub|}}}|<span class="my-template__subtitle">{{{sub}}}</span>}}
</div>
<div class="my-template__body">
{{{1|}}}
</div>
</div>{{#if:{{#varexists:MyTemplateCSS}} | | {{#vardefine:MyTemplateCSS|1}}<bstyle>/*<pre>*/
.my-template { 
  border: 1px solid #c8ccd1; 
  border-radius: 4px; 
}
.my-template__header { 
  background: #eaecf0; 
  padding: 10px 14px; 
}
.my-template__title { 
  font-weight: 600; 
}
.my-template__subtitle { 
  color: #54595d;
  margin-left: 8px;
}
.my-template__body {
  padding: 12px 14px;
}
/*</pre>*/</bstyle>}}</includeonly><noinclude>
== 用途 ==
...

代码由AI生成，模型是DeepSeek xxx

== 参数 ==
{| class="wikitable"
! 参数 !! 必填 !! 说明
|-
| <code>1</code> || 是 || 主要内容
|-
| <code>title</code> || 否 || 标题，默认"默认标题"
|}

== 示例 ==
<pre lang="wiki">
{{MyTemplate|content=这是内容}}
</pre>

{{MyTemplate|content=这是内容}}


<pre lang="wiki">
{{MyTemplate|title=示例|content=这是内容}}
</pre>

{{MyTemplate|title=示例|content=这是内容}}
</noinclude>
```

### 关键注意事项：
- `<div class="my-template__body">`后的换行是有意的，让`{{{content|}}}`内的wikitext能正常解析
- `<noinclude>`与`</includeonly>`之间不要有空行（会在调用处产生空段落）
- CSS去重块紧跟在HTML之后，不换行
- 注意检查参数完整性：文档中的每个参数（如type, id, title, content）都在模板主体中被实际使用
- 注意检查多行内容参数：所有支持多行的内容参数（如content）的输出位置是否独立占一行

---

## 六、杂项规范

### 1. 文档编写
- 模板文档里展示wikitext示例用`<pre lang="wiki">`（而非普通`<pre>`，可获得语法高亮）
- 所有示例应当完整可运行，展示效果可用实际调用（如`{{提示|示例内容}}`）
- 参数表格使用wikitable，清晰列出参数名、必填性、说明

### 3. 兼容性考虑
- 避免使用现代CSS特性（如`grid`、`flex`高级特性）若需兼容旧浏览器
- 移动端适配：使用相对单位（em/rem）、响应式设计
- 深色模式：考虑使用`@media (prefers-color-scheme: dark)`提供适配

### 4. 性能优化
- 减少嵌套层级，避免过深的DOM结构
- 复用通用样式类，减少CSS体积
- 对于大型模板，考虑在最后向用户提议拆分为子模板以提高维护性

### 5. 图标
- 除非用户主动提及，否则禁止Unicode图标、禁止Emoji、禁止SVG
- 仅在用户明确要求图标/给出图片信息时使用图标，比如[[File:logo.png|12px]]。

模板生成提示词 v0.1

测试结果：

GLM-5 模板:Notice
DeepSeek 模板:Notice2 网页版非思考 26.3.9
豆包专家模式模板:NoticeBox2
Gemini 3 Pro 模板:NoticeBox

# 任务

(这里描述你的需求，比如)请创建一个用于展示提示或警告信息的Wiki模板。该模板需要包含小标题和内容区域，采用扁平化设计风格。

# 模板编写说明
## 平台背景
BWiki是基于MediaWiki 1.37构建的Wiki平台，类似于灰机、Fandom、Miraheze等平台。关键扩展包括：
- Semantic MediaWiki、DynamicPageList3、LabeledSectionTransclusion
- Variables、Arrays、Loops、Scribunto
- ParserFunctions（含字符串函数）、ParserPower、RegexFunctions
- SimpleMathJax、WikiSEO

BWiki带有JQuery和Bootstrap V3（尽量不用，Bootstrap仅在需要时可用栅格系统）。

BWiki托管了大量的Wiki站点，内容以游戏为主，涵盖多个领域。用户参与了其中一个社区Wiki的编辑（不是BWiki本身）。

## 模板规范要求

### 文件结构
```wikitext
<includeonly>模板主体内容</includeonly><noinclude>
模板文档说明
</noinclude>
```

### Wikitext规范
- 优先使用Wikitext语法，避免不必要的HTML标签。
- 禁止行首空格，禁止缩进（会被解析器视为<pre>块）
- 换行处理：<includeonly>和<noinclude>标签前后不得换行，禁止多余换行（两个换行会被视为新段落，被加<p>，仅在需要时使用新段落）。
- 解析函数细节：解析器函数中，参数首尾的空格会被移除（这意味着 class="a{{#if:x| b}}"的结果是class=ab，并非a和b，如需用if添加额外的class，注意在#if前留出空格）
- 其他细节：禁止Unicode符号作为图标；wikitext的列表语法是星号*，子列表是多个星号，如**、***

### CSS规范
- 推荐方法：使用 #css 解析器函数（带安全过滤，禁用 url/var/attr/filter）如必须用相关特性，改用 <bstyle> 标签 
- 缩进换行：正常缩进，必须换行
- 类名规范：采用BEM命名法，禁止使用 bwiki 或 bw 前缀，需避免与现有类名/标签冲突
- 避免重复：模板会多次使用，因此需要仅首次调用时注入CSS，方式在下文代码模板参考中有示例
- 样式数量：避免引入大量CSS代码
- 注释：禁止注释
- 其他细节：禁止rem，无需指定font-family

### HTML规范
- 允许标签：仅限常见安全标签（div、span等）和MediaWiki解析器支持的扩展标签
- 标签使用：优先使用Wikitext语法，避免不必要的HTML标签
- 结构规范：避免复杂嵌套，行首非块级元素需用div包裹（避免被解析器识别为新段落强制加<p>）
- 缩进：禁止缩进、禁止行首空格
- 换行：非块级元素（如span）之前禁止换行（行首的非块级元素被视为新段落，需避免），块级元素如<div>前可换行

### 参数设计规范
- 参数类型：核心参数使用数字参数，非核心参数使用命名参数
- 默认值：所有参数必须提供合理的默认值
- 空值处理：使用 #if 判断空值时，注意避免生成空HTML标签和意外换行
- 模板名：禁止使用 bwiki 或 bw 平台相关名称

## 代码模板参考
```wikitext
<includeonly><!-- 模板内容 -->{{#if:{{#varexists: 模板名CSS }} || {{#vardefine: 模板名CSS | 1 }}{{#css:
/* CSS样式代码，不包含注释 */
}}}}<!-- 若需使用 bstyle，请改用以下写法 -->{{#if:{{#varexists: 模板名CSS }} || {{#vardefine: 模板名CSS | 1 }}<bstyle>/*<pre>*/
/* CSS样式代码 */
/*</pre>*/</bstyle>}}</includeonly><noinclude>
== 功能 ==
描述功能和边界

== 参数 ==
* 1：主要内容，默认值"默认内容"

== 示例 ==
<pre lang=wiki><!-- 示例，按需给出多个，首个采用最小化用法 -->
{{模板名|Hello World|参数名=super}}
</pre>

{{模板名|Hello World|参数名=super}}<!-- 实际展示结果 -->
</noinclude>
```

## 设计需求
- 能适配不同屏幕尺寸，按需做响应式设计
- 确保内容区域具有良好的可读性和间距

请基于以上要求设计模板结构、参数和UX，并编写完整的模板Wikitext代码，包括样式和文档。

AI 编辑环境配置

本站已预置 BWIKI-MCP，提供 Wiki 页面读写、解析验证等工具，配合支持 MCP 协议的 AI 客户端可通过对话完成编辑。

使用 Claude Code 示例

安装 Claude Code
按 BWIKI-MCP 安装配置 MCP
初始化cc，在CLAUDE.md 配置编辑规则入口，指引 AI 查阅 doc/ 下的规范

CLAUDE.md

# wiki 编辑规则入口

当用户提到 wiki 编辑相关的内容时，先去 `doc/` 目录下查找对应的规则文件，根据文件中的规则来执行操作。

## 规则文件索引

| 文件 | 适用场景 |
|------|----------|
| [doc/通用规范.md](doc/通用规范.md) | 所有 wiki 页面的通用规则（DocPage、语法高亮、图标、AI声明） |
| [doc/html规范.md](doc/html规范.md) | 模板和主名字空间的 HTML/CSS/JS 规则（标签限制、CSS 注入与去重、BEM），Widget 不受此限制 |
| [doc/wikitext规范.md](doc/wikitext规范.md) | Wikitext 语法规则（行首空格、换行） |
| [doc/模板规范.md](doc/模板规范.md) | 模板编码规则（结构、参数处理、性能、完整示例） |
| [doc/模板文档规范.md](doc/模板文档规范.md) | 撰写或修改模板的介绍文档、模板使用说明、模板示例等内容 |

> 新增规则文件时，在此索引中追加对应条目。

doc/通用规范.md

# 通用规范

所有 wiki 页面的通用规则。

## 统一文档样式
所有页面必须使用 `{{DocPage}}`。

## 代码语法高亮
展示 wikitext 用 `<pre lang=wiki></pre>`，加载：
- `{{#Widget:SyntaxhighlightCopy}}`
- `{{#Widget:SyntaxhighlightCollapsible}}`

## 优先使用 Wikitext
能用 Wikitext 实现的不用 HTML。

## 图标使用规范
除非用户主动提及，禁止 Unicode 图标、Emoji、SVG。用 `[[File:logo.png|12px]]` 加载。

## AI 参与声明
页面末尾添加 `{{页尾注释|AI参与类型|AI=<模型名>}}`：

- `{{页尾注释|AI生成|AI=<模型名>}}` — AI 直接生成
- `{{页尾注释|AI润色|AI=<模型名>}}` — 人工撰写，AI 润色

doc/html规范.md

# HTML 编写规范

模板和主名字空间的 HTML/CSS/JS 规则。Widget 页面不受此限制，可正常编写 HTML。

## HTML

### 标签使用规则

| 标签                         | 说明                                     |
| ---------------------------- | ---------------------------------------- |
| `<div>`、`<span>、<a>`   | 可用                                     |
| `<details>`、`<summary>` | 避免，兼容问题                           |
| `<style>`                  | 不支持，用 `<bstyle>`                  |
| `<script>`                 | 不支持，用 `{{#widget:}}`              |
| `<img>`                    | 不支持，用 `[[File:]]` 或 `{{图片}}` |
| `<iframe>`                 | 不生效                                   |
| `<button>`                 | 不生效                                   |
| `<input>`                  | 不生效                                   |

### 行首非块级元素

行首非块级元素会被强制包裹 `<p>`，用 `<div>` 包裹：

```wikitext
❌ <span>文字</span>
✅ <div><span>文字</span></div>
```

### class 拼接陷阱
解析器函数在 class 属性中首尾空格会被 trim：

```wikitext
❌ class="a{{#if:x| b}}" → 结果 "ab"
✅ class="a {{#if:x|b}}" → 结果 "a b"
```

### 条件属性空格
解析器函数条件属性的空格需要在函数外保留：

```wikitext
✅ <div {{#if:{{{id|}}}| id="{{{id}}}"}}>  ← id 前有空格
❌ <div{{#if:{{{id|}}}| id="{{{id}}}"}}>    ← id 前的空格会丢失
```

## CSS

### 注入方式

CSS 用 `<bstyle>` 包裹或 `{{#css:}}`（拦截 `url(`、`filter`，参数不能以注释开头）。

### 去重

模板复用，一次性内容用 `#varexists` + `#vardefine` 去重：

```wikitext
{{#if:{{#varexists:模板名CSS}} | | {{#vardefine:模板名CSS|1}}<bstyle>/*<pre>*/
/* 样式代码 */
/*</pre>*/</bstyle>}}
```

`<bstyle>/*<pre>*/` 和 `/*</pre>*/</bstyle>` 各自独占一行。变量名 `功能+类型`（如 `切换状态CSS`），页面内唯一。

### BEM 命名

```css
.tp-notice {}        /* 块 */
.tp-notice__title {} /* 元素 */
.tp-notice--warn {}  /* 修饰符 */
```

- 加前缀避免全局冲突（禁止 `bwiki`/`bw`）
- 禁止 `rem`，禁止 `font-family`

### CSS 兼容

避免 `grid`、`flex` 高级特性；移动端用相对单位；深色模式用 `@media (prefers-color-scheme: dark)`。

doc/wikitext规范.md

# Wikitext 编写规范

Wikitext 语法规则。

## 行首空格与缩进
**禁止行首空格 / 缩进**，会被视为 `<pre>` 块：

```wikitext
❌  {{模板名}}
✅ {{模板名}}
```

## 换行
两个连续换行会被视为新段落（包裹 `<p>`）。

doc/模板规范.md

# MediaWiki 模板规范

模板的编写规则，包括结构组织、参数处理、性能优化等。

## 平台背景

BWiki 基于 MediaWiki 1.37。关键扩展：SMW、DPL3、LST、Variables、Arrays、Loops、Scribunto、ParserFunctions、ParserPower、RegexFunctions、SimpleMathJax、WikiSEO。前端带 jQuery 和 Bootstrap V3（尽量不用）。

## 模板整体结构

所有模板必须采用以下标准结构：

```wikitext
<includeonly>模板正文</includeonly><noinclude>
模板说明文档
</noinclude>
```

说明文档必须包含：介绍、参数说明、示例。

## 换行控制

`<includeonly>` 标签本身会占位产生空行，必要时标签紧贴内容：

```wikitext
<includeonly><div>内容</div></includeonly><noinclude>
```

需要消除换行时可用 HTML 注释：

```wikitext
<div class="header"><!--
--><span class="title">标题</span><!--
--></div>
```

## 参数处理规范

### 参数设计原则
- **核心参数**用数字参数（`{{{1}}}`、`{{{2}}}`），**非核心参数**用命名参数
- 所有参数提供合理默认值：`{{{param|默认值}}}`

### 特殊字符转义
尽量避免在模板参数内嵌套 wikitext 表格，考虑用 HTML `<table>` 替代。

参数值中含等号时，用具名参数（位置参数 `1=`）规避，不需要 `{{=}}`：

```wikitext
{{模板|1=含=号的内容}}
```

### 空值判断
- 未传参时 `{{{param|}}}` 返回空字符串
- 可以用 `#if` 对空字符串判为假
- 需要避免生成冗余 HTML 时用 `#if` 包裹，不影响视觉时可省略

```wikitext
{{#if:{{{desc|}}}|<span class="desc">{{{desc}}}</span>}}
```

### 多行内容参数
参数在用于接收可能包含多行 wikitext 的内容时，参数值必须**独立占一行**，否则列表、标题等行首语法无法正常解析：

```wikitext
✗  <div class="body">{{{1|}}}</div>
✓  <div class="body">
{{{1|}}}
</div>
```

## 性能
- 减少嵌套层级，避免过深的DOM结构
- 复用通用样式类，减少CSS体积
- 对于大型模板，考虑拆分为子模板以提高维护性

## 完整代码示例

```wikitext
<includeonly><div class="my-template" {{#if:{{{id|}}}| id="{{{id}}}"}}>
<div class="my-template__header"><!--
--><span class="my-template__title">{{{title|默认标题}}}</span><!--
-->{{#if:{{{sub|}}}|<span class="my-template__subtitle">{{{sub}}}</span>}}
</div>
<div class="my-template__body">
{{{1|}}}
</div>
</div>{{#if:{{#varexists:MyTemplateCSS}} | | {{#vardefine:MyTemplateCSS|1}}<bstyle>/*<pre>*/
.my-template { 
  border: 1px solid #c8ccd1; 
  border-radius: 4px; 
}
.my-template__header { 
  background: #eaecf0; 
  padding: 10px 14px; 
}
.my-template__title { 
  font-weight: 600; 
}
.my-template__subtitle { 
  color: #54595d;
  margin-left: 8px;
}
.my-template__body {
  padding: 12px 14px;
}
/*</pre>*/</bstyle>}}</includeonly><noinclude>
== 用途 ==
这是一个用于展示提示信息的模板。

代码由AI生成，模型是DeepSeek

== 参数 ==
{| class="wikitable"
! 参数 !! 必填 !! 说明
|-
| <code>1</code> || 是 || 主要内容
|-
| <code>title</code> || 否 || 标题，默认"默认标题"
|}

== 示例 ==
<pre lang="wiki">
{{MyTemplate|这是内容}}
</pre>

{{MyTemplate|这是内容}}

<pre lang="wiki">
{{MyTemplate|title=示例|这是内容}}
</pre>

{{MyTemplate|title=示例|这是内容}}
</noinclude>
```

doc/模板文档规范.md

# MediaWiki 模板文档撰写规范

模板介绍文档的撰写规则。按以下 4 个模块组织内容。

## 1. 基础说明
- **用途**：句式"这是一个用于 [具体用途] 的模板"
- **限制**：30 字以内

## 2. 使用说明
- **标题**：`==参数==`
- **参数示例**：填充所有参数调用，参数用 `<>` 包裹，用 `<pre lang=wiki></pre>`
- **参数列表**：`class=wikitable`，分两列标明名称和说明

## 3. 示例
- **标题**：`==用法==`
- **顺序**：从最少到最多参数逐步展示
- **每个用法**：
  - 描述性标题，如 `===基本使用===`
  - 代码示意：`<pre lang=wiki></pre>`
  - 效果演示：下方直接调用模板

## 4. 其他
- **依赖**：列出模板实现（`<includeonly>`）所需的依赖项（`DocPage` 等不计入）
- **转载**：列出来源并致谢

## 5. 语法要求
- **参数换行**：每个参数独占一行
- **代码块**：用 `<pre lang=wiki></pre>`
- **参数完整性**：文档的每个参数都必须在 `<includeonly>` 中被实际使用
- **禁止**：
  - 空格/Tab 格式化模板
  - 模板链接用 `[[模板:xxx]]`，不用 `[[Template:xxx]]`

## 案例

```
此模板用于xxx，负责xxx

==参数==
<pre lang=wiki>
{{模板名
|参数1=<值1>
|参数2=<值2>
}}
</pre>
{|class="wikitable"
!必填参数!!说明
|-
|<值1>||参数1的说明
|}
{|class="wikitable"
!选填参数!!说明
|-
|<值2>||参数2的说明
|}

==用法==
===基本使用===
<pre lang=wiki>{{模板名|参数1=值1}}</pre>
{{模板名|参数1=值1}}

===完整参数===
<pre lang=wiki>
{{模板名
|参数1=值1
|参数2=值2
}}
</pre>
{{模板名|参数1=值1|参数2=值2}}

==其他==
*依赖页面
**[[页面名]]
*转载
**此模板转自xxxx
```