本文定位：面向 Fandom 平台新编辑者的系统性参考文档。前半部分介绍 Fandom 平台的基本概念与内容创建流程，后半部分详细讲解 Wikitext 编辑语法的完整用法。

第一部分：Fandom 平台概述

一、认识 Fandom

1.1 什么是 Fandom

Fandom（原名 Wikia）是全球最大的粉丝社群平台之一，托管着数以百万计的 Wiki 站点。每个 Wiki 围绕一个特定主题（如影视作品、游戏、动漫、音乐等）由粉丝社群共同创建和维护。

Fandom 基于 MediaWiki 引擎构建，后者也是 Wikipedia 所使用的开源维基软件。这意味着 Fandom 的编辑语法与 Wikipedia 高度兼容，同时增加了一些面向粉丝社区的专属功能。

1.2 核心概念

1.3 用户角色与权限体系

Fandom 的用户角色从低到高分为以下层级：

群组聊天（Chat）与讨论版（Discussions） 也有独立的权限体系，由管理员配置。

二、内容创建流程

2.1 从零开始创建页面

1. 确认目标：确定页面主题，搜索确认该页面是否已存在
2. 进入编辑：点击页面右上角的”编辑”按钮，或在搜索框输入不存在的页面名后点击”创建此页面”
3. 选择编辑器：可选择源代码编辑器或可视化编辑器
4. 编写内容：使用 Wikitext 语法编写正文
5. 添加分类：在页面底部添加 [[分类:XXX]] 归类
6. 预览检查：使用预览功能确认显示效果
7. 填写编辑摘要：简要描述本次修改内容（如”创建页面”、“修正笔误”）
8. 保存发布：点击”保存更改”

2.2 编辑规范建议

• 每个页面的标题应唯一且含义清晰
• 首次创建时使用小页面模式，逐步扩充内容
• 善用预览功能避免语法错误
• 编辑摘要应当简洁明了，方便其他编辑者了解变更内容
• 遵循所在 Wiki 的风格指南（如有）

第二部分：Wikitext 编辑语法详解

三、编辑器模式

Fandom 提供两种编辑器，各有优劣：

建议：掌握源代码编辑器的使用是成为高效编辑者的关键。可视化编辑器在遇到复杂排版时往往无法精确控制效果，需要切换到源代码模式进行调整。

四、文本格式化

4.1 基本样式

效果示例：

'''洛疏律'''是一位茶客，身高''178CM''，体重''62KG''。
<s>以下内容已过时</s>
水的化学式是 H<sub>2</sub>O，圆的面积公式是 πr<sup>2</sup>。
使用 <code>mediawiki.api()</code> 方法可以调用 API。

实际渲染效果：

洛疏律是一位茶客，身高178CM，体重62KG。 以下内容已过时 水的化学式是 H₂O，圆的面积公式是 πr²。 使用 mediawiki.api() 方法可以调用 API。

4.2 段落与换行

这是第一段落的内容，可以包含多行文字。
空行之后即开始新的段落。

这是第二段落的内容。
这是同一段落内的<br>换行效果。

五、标题与目录

5.1 标题语法

标题使用等号 = 包裹，从二级标题开始（一级保留给页面标题本身）：

== 一级标题 ==        <!-- 页面的主要章节 -->
=== 二级标题 ===       <!-- 章节下的子章节 -->
==== 三级标题 ====     <!-- 子章节下的细分 -->
===== 四级标题 =====   <!-- 更细分的层级 -->
====== 五级标题 ====== <!-- 最深层级 -->

语法规则：

• 标题必须从 ==（二级）开始，不可使用 =（一级）
• 等号前后建议加一个空格，便于阅读
• 每个标题独占一行
• 标题内容不宜过长
• 同一页面中应避免标题名称重复（会导致锚点冲突）

5.2 目录控制

Fandom 会自动根据页面中的标题生成目录（Table of Contents，简称 TOC），默认放置在第一个标题之前。

使用魔法字控制目录行为：

__NOTOC__        <!-- 本页不显示目录 -->
__TOC__          <!-- 在指定位置显示目录 -->

== 生平简介 ==
（内容...）

== 角色能力 ==
（内容...）

六、链接系统

链接是 Wiki 的核心功能，Fandom 支持多种链接类型。

6.1 内部链接

指向同一 Wiki 内其他页面的链接：

重要特性：

• 内部链接中的首字母不区分大小写（Fandom 默认首字母大写）
• 空格会被自动转换为下划线 _
• 如果目标页面不存在，链接会显示为红色，提示可创建该页面

示例：

[[洛疏律]]是[[茶馆设定]]中的一位茶客。
更多角色请参见[[茶馆设定/角色列表|角色列表]]。
关于其性格分析，详见[[洛疏律#性格|性格特征]]。

6.2 外部链接

指向其他网站的超链接：

示例：

官方站点：[https://www.fandom.com Fandom官方网站]
更多信息请访问 https://community.fandom.com

6.3 跨语言链接

Fandom 支持通过跨语言链接关联同一主题的不同语言版本：

[[en:Luoshulv]]
[[ja:洛疏律]]

这些链接通常放在页面末尾，会在侧边栏的”其他语言”区域显示。

6.4 文件与分类链接

使用冒号前缀可创建指向文件描述页或分类页的普通链接（而非嵌入或归类）：

[[:文件:示例.jpg]]      <!-- 指向文件描述页的链接，而非嵌入图片 -->
[[:分类:人物]]           <!-- 指向分类页的链接，而非将页面归入该分类 -->

七、列表

7.1 无序列表

使用星号 * 表示，层级越多星号越多：

* 水果
* 茶饮
** 蜂蜜柚子茶
*** 热饮
*** 冷饮
** 茉莉柚茶
* 甜点

渲染效果：

• 水果
• 茶饮
  • 蜂蜜柚子茶
    • 热饮
    • 冷饮
  • 茉莉柚茶
• 甜点

7.2 有序列表

使用井号 # 表示，自动编号：

# 打开页面编辑器
# 填写内容
## 添加标题
## 插入图片
# 预览检查
# 保存发布

渲染效果：

1. 打开页面编辑器
2. 填写内容
   1. 添加标题
   2. 插入图片
3. 预览检查
4. 保存发布

7.3 混合列表

无序列表和有序列表可相互嵌套：

# 第一步：准备材料
#* 茶叶
#* 热水
#* 茶杯
# 第二步：冲泡
#* 温杯
#* 洗茶
#* 冲泡

渲染效果：

1. 第一步：准备材料
   • 茶叶
   • 热水
   • 茶杯
2. 第二步：冲泡
   • 温杯
   • 洗茶
   • 冲泡

7.4 定义列表

使用分号 ; 定义术语，冒号 : 定义说明：

; 姓名
: 洛疏律
; 种族
: 人类
; 身高
: 178CM
; 特征
: 沉稳冷静，善于品茶
: 精通剑术

渲染效果：

• 姓名
  • 洛疏律
• 种族
  • 人类
• 身高
  • 178CM
• 特征
  • 沉稳冷静，善于品茶
  • 精通剑术

7.5 列表编写注意事项

• 列表项之间不要空行（空行会结束列表）
• 混合使用 * 和 # 时注意缩进层级一致
• 同一层级使用相同的标记符号

八、表格

表格是 Wikitext 中最具表现力的排版工具之一。

8.1 基本表格结构

{| class="wikitable"
|+ 表格标题（可选）
! 表头1 !! 表头2 !! 表头3
|-
| 行1列1 || 行1列2 || 行1列3
|-
| 行2列1 || 行2列2 || 行2列3
|}

标记说明：

8.2 完整表格示例

{| class="wikitable" style="text-align: center; width: 80%;"
|+ 洛疏律个人资料
! 类别 !! 内容 !! 备注
|-
| 身高 || 178CM || 标准身材
|-
| 体重 || 62KG || 
|-
| 喜欢的茶 || 蜂蜜柚子茶 || 四季常饮
|-
| 技能 || 剑术、茶道 || 自幼修习
|}

8.3 表格高级用法

合并单元格：

{| class="wikitable"
! 项目 !! 数值
|-
| rowspan="2" | 身高体重 || 178CM
|-
| 62KG
|-
| colspan="2" | 注：数据来自官方设定集
|}

渲染效果： （由于Astro和Fandom的语法差异，表格的样式可能会有差异）

设置单元格样式：

{| class="wikitable"
! 角色
! style="width: 100px;" | 身高
! 特点
|-
| 洛疏律
| style="text-align: right;" | 178CM
| 沉稳
|-
| style="background: #f0f0ff;" | 洛疏律
| style="text-align: right;" | 165CM
| 温柔
|}

可用的表格 class：

九、图片与媒体文件

9.1 插入图片

基本语法：

[[文件:文件名.jpg|参数1|参数2|...|说明文字]]

常用参数组合：

完整示例：

[[文件:洛疏律.jpg|thumb|right|300px|洛疏律的官方立绘，由画师 XXX 绘制]]

参数详解：

9.2 图片画廊（Gallery）

使用 <gallery> 标签创建图片画廊：

<gallery>
洛疏律.jpg|立绘1
洛疏律_战斗.jpg|战斗姿态
洛疏律_日常.jpg|日常装束
</gallery>

gallery 参数：

<gallery widths="150" heights="150" perrow="3" caption="角色图鉴">
洛疏律.jpg|洛疏律
1.jpg|1
2.jpg|2
</gallery>

9.3 嵌入视频与音频

YouTube 视频：

<youtube>https://www.youtube.com/watch?v=VIDEO_ID</youtube>

Vimeo 视频：

<vimeo>https://vimeo.com/VIDEO_ID</vimeo>

音频文件（使用 [[文件:]] 语法）：

[[文件:配乐.ogg]]
[[文件:音效.mp3]]

十、引用与脚注

引用系统用于标注信息来源或添加补充说明。

10.1 行内引用

在引用内容后添加 <ref> 标签：

洛疏律身高178CM<ref>出自茶客设定</ref>，体重62KG<ref>同上</ref>。

10.2 显示参考文献

在页面末尾使用 <references /> 自动列出所有引用：

== 参考文献 ==
<references />

10.3 命名引用（复用）

对同一来源的多次引用使用命名引用，避免重复：

洛疏律是一位茶客<ref name="background">1</ref>。
2<ref name="background" />。
3<ref name="background" />。

10.4 独立列出的参考文献

<references>
<ref name="book1"><《超新星纪元》>，第4页</ref>
<ref name="book2">《超新星纪元》，第1页</ref>
</references>

10.5 多列参考文献

当引文较多时，可使用多列显示：

<div class="references-small" style="-moz-column-count:2; column-count:2;">
<references />
</div>

十一、代码与格式

11.1 行内代码

使用 <code> 标签包裹行内代码片段：

使用 <code>console.log()</code> 方法输出调试信息。

11.2 语法高亮代码块

使用 <syntaxhighlight> 标签创建带语法高亮的代码块：

<syntaxhighlight lang="python">
def greet(name):
    """向指定用户打招呼"""
    return f"你好，{name}！"

print(greet("洛疏律"))
</syntaxhighlight>

支持的语言：

lang 参数支持常见编程语言：python、javascript、html、css、java、c、cpp、rust、go、ruby、php、sql、bash、json、xml 等。

11.3 纯文本预格式化块

使用 <pre> 标签保留所有空格和换行，无语法高亮：

<pre>
  行首的缩进
  和所有    空格
  都     会被保留
</pre>

11.4 行首空格缩进

在行首使用一个或多个空格也可以实现简单的预格式化（类似 <pre>，但无边框）：

 这是使用行首空格缩进的文本，
 会保留所有空格和换行，
 并用等宽字体显示。

十二、模板

模板是 Fandom 最强大的功能之一，用于封装可复用的内容片段。

12.1 模板的基本调用

{{模板名}}                     <!-- 无参数调用 -->
{{模板名|参数值}}              <!-- 单一参数 -->
{{模板名|参数1|参数2|参数3}}    <!-- 多个匿名参数 -->
{{模板名|参数名=参数值}}        <!-- 命名参数 -->

12.2 模板的完整使用示例

假设 Wiki 中存在模板 角色信息框：

{{角色信息框
| 姓名    = 洛疏律
| 图像    = 洛疏律.jpg
| 身高    = 178CM
| 体重    = 62KG
| 种族    = 人类
| 年龄    = 24岁
| 职业    = 茶客
| 喜好    = 蜂蜜柚子茶、剑术
}}

12.3 常用系统模板（未实装）

12.4 模板参数说明

模板参数有两种传递方式：

十三、注释与说明

Wikitext 中的注释不会被渲染到最终页面中。

13.1 HTML 注释

<!-- 这是一段注释，仅在源代码编辑器中可见 -->
<!--
多行注释
也是支持的
-->

13.2 不解析标记（Nowiki）

使用 <nowiki> 标签阻止 Wikitext 语法被解析：

<nowiki>'''这段文字不会被渲染为粗体'''</nowiki>
<nowiki>[[链接]]不会被解析</nowiki>

实际输出：

'''这段文字不会被渲染为粗体''' [[链接]]不会被解析

13.3 附加说明块

使用 HTML <div> 添加样式化的说明区域：

<div class="note" style="background: #f5f5f5; padding: 10px; border-left: 4px solid #3399ff;">
**提示**：本文尚在建设中，欢迎参与编辑。
</div>

<div class="warning" style="background: #fff5f5; padding: 10px; border-left: 4px solid #ff3333;">
**剧透警告**：以下内容包含关键剧情，请谨慎阅读。
</div>

十四、魔法字与系统变量

魔法字（Magic Words）是 Fandom 内置的特殊字符串，可自动输出系统信息或控制页面行为。

14.1 系统变量

14.2 行为控制魔法字

十五、重定向

重定向用于将一个页面自动跳转到另一个页面。

15.1 基本重定向

#redirect [[目标页面名称]]
#重定向 [[目标页面名称]]

15.2 带片段的重定向

#redirect [[洛疏律#性格]]

15.3 使用说明

• 重定向指令必须放在页面最开头，前面不能有任何内容
• 重定向页面会保留版本历史，不会被删除
• 访问重定向页面时会自动跳转到目标页面，并显示”重定向自 XXX”的提示
• 如果要覆盖重定向，直接编辑该页面修改内容即可
• 中英文 #redirect 和 #重定向 均可使用

十六、分类与标签

分类是 Fandom 组织内容的基石。

16.1 为页面添加分类

[[分类:人物]]
[[分类:茶馆设定]]

16.2 指定分类排序

使用管道符 | 指定在分类页面中的排序名称：

[[分类:人物|洛疏律]]
[[分类:茶馆设定|洛]]

如果不指定排序名称，默认按页面标题排序。指定排序可以控制同一分类中各页面的排列顺序。

16.3 分类的注意事项

• 分类通常放在页面末尾
• 同一页面可属于多个分类
• 分类本身也是一个页面，可以编辑其描述文字
• 分类可以嵌套（如 分类:角色 下包含 分类:主角 和 分类:配角）
• 使用 [[:分类:人物]]（冒号前缀）可创建指向分类页的普通链接

十七、常用 HTML 标签

Wikitext 中可以直接使用部分 HTML 标签。以下为常用标签汇总：

17.1 块级标签

17.2 行内标签

17.3 使用 HTML 标签的注意事项

• <table> 标签与 Wikitext 表格语法 {| ... |} 互斥，不可混用
• 优先使用 Wikitext 原生语法（更简洁，且能在可视化编辑器中正确显示）
• 复杂的 HTML 结构可能无法在可视化编辑器中正常显示
• 避免使用过时的标签如 <font>、<center>，推荐使用 CSS 替代
• 内联样式（style="..."）使用 CSS 属性，建议使用 class 类名

十八、高级功能

18.1 解析器函数（Parser Functions）

解析器函数是以 # 开头的特殊模板调用，用于实现条件判断、字符串处理等逻辑。

条件判断：

{{#if: {{{参数|}}} | 参数存在时显示 | 参数不存在时显示 }}
{{#ifeq: 值1 | 值2 | 相等时显示 | 不相等时显示 }}
{{#ifexpr: 1 > 0 | 真时显示 | 假时显示 }}

示例：

{{#ifeq: {{PAGENAME}} | 洛疏律 | 这是茶客页面 | 这是其他页面 }}

选择分支：

{{#switch: {{PAGENAME}}
| 洛疏律 = 欢迎来到茶客页面
| 茶馆设定 = 这是世界观页面
| #default = 其他页面
}}

18.2 字符串处理

{{#len: 字符串}}              <!-- 返回字符串长度 -->
{{#sub: 字符串 | 起始位置 | 长度 }}  <!-- 截取子串 -->
{{#pad: 5 | 3 | 0 }}          <!-- 填充为 005 -->
{{lc: 大写转小写}}              <!-- 转换为小写 -->
{{uc: 小写转大写}}              <!-- 转换为大写 -->

18.3 URL 处理

{{#urlencode: 查询参数}}          <!-- URL 编码 -->
{{#anchorencode: 章节标题}}       <!-- 锚点编码 -->
{{fullurl: 页面名}}               <!-- 生成完整 URL -->
{{fullurl: 页面名|action=edit}}   <!-- 生成编辑链接 -->

18.4 命名空间检测

{{#if: {{NAMESPACE}} | 当前在 {{NAMESPACE}} 命名空间 | 当前在主命名空间 }}

18.5 扩展标签

Fandom 支持丰富的扩展标签，用于嵌入外部内容：

十九、常见问题与调试技巧

19.1 语法不生效的常见原因

19.2 调试方法

1. 使用预览功能：在保存前预览，可即时发现语法错误
2. 逐步排查：当页面出现异常时，逐段移除内容定位问题
3. 查看源代码：学习已有页面的 Wikitext 写法，复制成功模式
4. 查看差异：比较不同版本间的差异，了解修改的影响
5. 沙盒测试：在个人沙盒页面中测试复杂语法

19.3 高效编辑技巧

• 使用 搜索并替换 批量修改同类内容
• 善用 复制粘贴 模板调用，避免重复输入
• 常用代码片段可保存为个人模板
• 使用 编辑摘要 标记编辑类型（如”小修改”）
• 大段编辑建议先复制到本地文本编辑器，防止意外丢失

二十、Markdown 与 Wikitext 语法对照

对于熟悉 Markdown 的编辑者，下表可帮助快速对照学习：

二十一、相关资源

• Fandom 官方帮助：编辑指南 — Fandom 官方编辑帮助
• MediaWiki Wikitext 完整参考 — MediaWiki 官方语法参考
• Fandom 社区帮助中心（中文） — 中文帮助文档
• Fandom 模板帮助 — 模板的详细用法
• 解析器函数帮助 — 解析器函数完整文档
• Fandom 开发者中心 — 高级自定义与 JavaScript 开发

二十二、总结

Fandom 的 Wikitext 语法功能强大，涵盖了从基础文本排版到高级模板编程的完整能力。对于新编辑者，建议按以下路径逐步学习：

1. 入门阶段：掌握文本格式化、链接、列表、图片插入即可创建基本页面
2. 进阶阶段：学习表格、模板、引用系统，可创建结构更丰富的页面
3. 高级阶段：掌握解析器函数、扩展标签、HTML/CSS 自定义，可构建复杂的信息框架

核心建议：多阅读其他优秀 Wiki 的源代码，边编辑边预览，在实践中快速成长。Fandom 社区有丰富的帮助文档和友善的编辑者社群，遇到问题时善用这些资源。

本文档基于 Fandom 最新平台特性编写，如需获取最新信息请参考官方帮助文档。