帮助:Wikitext

wikitext即维基文本，又称wiki标记、wiki代码，包含许多参数和关键字，被MediaWiki软件用来格式化页面。本wiki使用MediaWiki软件，因此显然使用wikitext格式化页面。Help:编辑页面包含怎样阅读这种标记语言与保存编辑的方式。通常代码可以直接复制粘贴，而不用编写新代码。Project:Wikitext备忘单列出了标记的简短列表和提示。

一些HTML元素也可用来编排格式。相关信息请参考Help:Wikitext中的HTML。

其他教程

其实很多地方都有wikitext教程，但这个轮子还是要造，虽然要造很久。

这里放一些收集到的wikitext教程。

• mw:Help:Formatting/zh — MediaWiki官网的格式化文本帮助
• wikipedia:Help:Wikitext — 英文维基百科的wikitext帮助
• wikipedia:zh:Help:编辑页面 — 中文维基百科的编辑页面帮助，也包含一些wikitext示例。
• 帮助:编辑页面 - 灰机wiki — 同样包含wikitext示例。
• 使用源代码编辑MediaWiki - RIA 论坛 — 发布在论坛的散乱编辑帮助。

布局

章节

章节标题

章节标题标记由一对数量在1到6个之间的等号（=）构成，代表1级到6级标题，彼此之间具有关联性。等号间套着的东西就是章节的标题。

• 1级标题（一对等号）规定为页面的标题，会自动由软件生成在页面正文上方，不要在编辑中使用。
• 章节标题的样式由CSS指定，标题后会生成“[编辑]”链接。
• 含有4个及以上标题的页面会自动生成目录。
• 不要在标题代码一行内添加其他内容，这样标题会失效，或者让章节标题无法自动添加到编辑摘要中。

源代码	显示
= 1级标题 = == 2级标题 == === 3级标题 === ==== 4级标题 ==== ===== 5级标题 ===== ====== 6级标题 ======	1级标题 2级标题 3级标题 4级标题 5级标题 6级标题
== 这个标题 == 不会生效	== 这个标题 == 不会生效

在添加标题示例时使用{{Fake heading}}模板。

水平分割线

水平分割线代表段落级元素间的主题转换，比如故事中场景的改变，一个章节中主题的改变。除非你知道自己在做什么，否则就不要在条目中使用，尤其不要用它来分隔段落和下个标题。

源代码	显示
孝太郎只是轻轻一碰，由莉佳就应声倒下。 『她昏倒了？』 「真可怜，一定是被吓昏的。」 「没用的家伙……」 由莉佳难以承受静香带来的压力，就这样失去了意识。 ---- 在静香的主导之下，大家总算是达成了共识，同时也将共识诉诸书面文字。内容主要是借由和平的方法决定房间的所有人、不许破坏可乐娜庄、不许妨碍左邻右舍的安宁、不许将争执带出房间、入夜之后轻声细语……等项目。之后，他们将这份协议命名为《可乐娜陆战规定》。	孝太郎只是轻轻一碰，由莉佳就应声倒下。 『她昏倒了？』 「真可怜，一定是被吓昏的。」 「没用的家伙……」 由莉佳难以承受静香带来的压力，就这样失去了意识。 在静香的主导之下，大家总算是达成了共识，同时也将共识诉诸书面文字。内容主要是借由和平的方法决定房间的所有人、不许破坏可乐娜庄、不许妨碍左邻右舍的安宁、不许将争执带出房间、入夜之后轻声细语……等项目。之后，他们将这份协议命名为《可乐娜陆战规定》。

不要这样做！

源代码	显示
<big>一个伪标题</big> ----	一个伪标题
章节末尾 ---- == 下一个章节标题 ==	章节末尾 下一个章节标题

等效HTML：<hr />（这个可以缩进（如* 第1部分 <hr />）第2部分。而使用wikitext形式时，代码只能位于行首。）

目录

在页面至少有4个章节标题时，目录会自动生成在导言部分和首个章节标题之间。可以使用以下魔术字或模板控制目录：

• __FORCETOC__：强制在正常位置显示目录，忽略标题数量。
• __TOC__：强制在放置此魔术字的位置显示目录。
• __NOTOC__：禁用目录。

换行符、段落

换行符指wikitext代码中的换行符，源代码编辑器中击↵ Enter键将插入换行符。

段落表示文章中相对独立的句子或句群，有相对完整的意思。排版中，段落间会留有空间。

• 在代码中按两次↵ Enter，使前面的文本与后面的文本之间留有一空行，后面的文本将作为新段落。
• 代码中换一次行通常不会在阅读时显示。如果是使用前一行的末尾不是汉字（或其他东亚方块字）或全角标点，则阅读时字母后会有一空格。
• 粗体、斜体这类标记会在换行处中止。

源代码	显示
这里的一个换行符 对布局没有影响。 但是一个新段落, 或位于列表或缩进后的文本 会产生一个空行。	这里的一个换行符 对布局没有影响。 但是一个新段落, 或位于列表或缩进后的文本 会产生一个空行。

模板：{{Clear}}可以在指定位置将后续正常内容移动到浮动内容下方。

断行

断行是在段落中的某个位置插入的，阅读时可见的换行，断行后的文本与断行前的文本同属一个段落。断行可能在排版诗歌时有用。使用<br />会在当前位置插入一个断行。为了阅读源代码方便，可以在需要断行处换一次行，并将<br />标签放置在第一行末尾或第二行行首，这样对排版没有影响。

源代码	显示
… 银瓶乍破水浆迸，铁骑突出刀枪鸣。<br /> 曲终收拨当心画，四弦一声如裂帛。<br /> 东船西舫悄无言，唯见江心秋月白。 沉吟放拨插弦中，整顿衣裳起敛容。<br /> 自言本是京城女，家在虾蟆陵下住。<br /> 十三学得琵琶成，名属教坊第一部。 …	… 银瓶乍破水浆迸，铁骑突出刀枪鸣。 曲终收拨当心画，四弦一声如裂帛。 东船西舫悄无言，唯见江心秋月白。 沉吟放拨插弦中，整顿衣裳起敛容。 自言本是京城女，家在虾蟆陵下住。 十三学得琵琶成，名属教坊第一部。 …

缩进文本

增加文本到页面一侧的距离（在从左往右书写的语言中是左边），一般用在讨论页。

wikitext中，一般缩进方发“借用”了描述列表中描述元素（<dd>）的标记，虽然这种方法不能通过HTML验证。

源代码	显示
缩进一般使用于讨论页： : 每个冒号都在一行的最前面。 :: 增加该行的缩进级别。 ::: （只要不在编辑中换行，缩进就会继续。） ::: 缩进需要换行时，在新行文本前添加与前一行相同数量的冒号。 ::: <p>或者这样</p><p>（如果是为了起一个新段落而换行）</p> :::: 每个回复都应添加一个冒号。 ::::: 依此类推… :::::: 等等… {{outdent|::::::}} 重设缩进模板可以给出直观的提示，显示我们重置了缩进（这里是6层）	缩进一般使用于讨论页： 每个冒号都在一行的最前面。 增加该行的缩进级别。 （只要不在编辑中换行，缩进就会继续。） 缩进需要换行时，在新行文本前添加与前一行相同数量的冒号。 或者这样 （如果是为了起一个新段落而换行） 每个回复都应添加一个冒号。 依此类推… 等等… 重设缩进模板可以为重置缩进提供直观的提示（这里是6层）

模板：{{Outdent}}

块引用

可以在需要插入一块来自其他文章的文本，并需要与正文作区分时使用块引用。

源代码	显示
正文… <blockquote> '''blockquote'''标签会往页面两边添加边距，而冒号只会从左侧缩进。 块引用左边也会有一条浅灰色装饰线。 </blockquote> 正文…	正文… blockquote标签会往页面两边添加边距，而冒号只会从左侧缩进。 块引用左边也会有一条浅灰色装饰线。 正文…

居中文本

源代码	显示
<div class="center" style="margin-left: auto; margin-right: auto; width: auto;">居中文本</div>	居中文本

一般来说，不需在条目中居中文本，除非你要整点排版花活。上方代码生成的盒子边框贴着文本。如果只需要居中文本，可使用下方代码：

源代码	显示
<div style="text-align: center;">居中文本</div>	居中文本

不要过时的使用<center>…</center>。

右对齐文本

在单独的容器里包含右齐文本：

源代码

显示

<div style="margin-left: 1em; direction: ltr; text-align: right;">右对齐的文本</div>

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. 右对齐的文本 Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

或者让文本向右浮动，正常文本环绕着它：

源代码

显示

<div class="floatright">向右浮动的文本</div>

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. 向右浮动的文本 Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

列表

MediaWiki软件将列表项间的空行解释为结束当前列表，所以请不要在一个列表的列表项之间留空行。

无序列表

前面有小圆点（或其他形状）的列表，在项目顺序不重要时使用。

源代码	显示
* 项 1 * 项 2 * 项 3 * 项 4 ** 子项 4 a) *** 子项 4 a) 1. **** 子项 4 a) 1. i) **** 子项 4 a) 1. ii) ** 子项 4 b) * 项 5	项 1 项 2 项 3 项 4 子项 4 a) 子项 4 a) 1. 子项 4 a) 1. i) 子项 4 a) 1. ii) 子项 4 b) 项 5

HTML标记：

<ul>
  <li>项 1</li>
  <li>项 2</li>
  <li><ul>
    <li>项 2.1</li>
    <li>项 2.2</li>
  </ul></li>
  <li>项 3</li>
</ul>

有序列表

源代码	显示
# 项 1 # 项 2 # 项 3 # 项 4 ## 子项 4.1 ### 子项 4.1.1 #### 子项 4.1.1.1 ## 子项 4.2 # 项 5	项 1 项 2 项 3 项 4 子项 4.1 子项 4.1.1 子项 4.1.1.1 子项 4.2 项 5

HTML标记：

<ol>
  <li>项 1</li>
  <li>项 2</li>
  <li><ol>
    <li>项 2.1</li>
    <li>项 2.2</li>
  </ol></li>
  <li>项 3</li>
</ol>

描述列表

将半角分号（;）放在行首，后跟术语，后面放一个半角冒号（:），后跟术语的描述或定义，就能创建一段描述列表。这种格式也可用于其他场景，如载具的各种型号。

描述列表由组名和其所对的值组成。组名（术语）为粗体，值（描述）向右缩进。每组列表必须包含一或多条描述。如果只有术语一条描述，分号和冒号可以放在同一行（行首为分号，冒号前是术语，冒号后是描述）。但如果有多条描述，则每条描述都得放在单独的一行，行首为半角冒号。

不要使用分号加粗一整行，否则，页面将无法通过HTML5验证，屏幕阅读器读取有页面时也会出现问题。使用冒号缩进也会有同样的问题，所以仅应在讨论页使用。

源代码	显示
; 项目 : 描述	项目 描述
; 项目 1 : 描述 1.1 : 描述 1.2 : 描述 1.3 ; 项目 2 : 描述 2.1 : 描述 2.2 ; 另外的一个列表 : 描述 β1.1 : 描述 β1.2	项目 1 描述 1.1 描述 1.2 描述 1.3 项目 2 描述 2.1 描述 2.2 另外的一个列表 描述 β1.1 描述 β1.2

HTML标记：

<dl>
  <dt>项目 1</dt>
  <dd>描述 1.1</dd>
  <dd>描述 1.2</dd>
  <dt>项目 2</dt>
  <dd>描述 2.1</dd>
  <dd>描述 2.2</dd>
</dl>

格式

格式化文本

描述	输入	输出
斜体、粗体、模板:Smallcaps	在文本两边放上2个连续直引号将文本变为''斜体''。 两边放3个直引号则会'''加粗'''文本。 放上5个（斜体2个，粗体3个）会产生'''''粗斜体'''''。 ''斜体''和'''粗体'''用在一行内时才能正常显示。如果中途换了行，后面的标记跑到下一行去了，就只有前面一行会应用此格式。	在文本两边放上2个连续直引号将文本变为斜体。 两边放3个直引号则会加粗文本。 放上5个（斜体2个，粗体3个）会产生粗斜体。 斜体和粗体用在一行内时才能正常显示。如果中途换了行，后面的标记跑到下一行去了，就只有前面一行会应用此格式。
正常文本内的小型源代码区块。 源代码会用等宽字体显示。	函数<code>int m2()</code>是好的。	函数int m2()是好的。
小型文本，用来标注正常文本之间的注释。	仅在必要时使用<small>小型文本</small>。使用Minerva Neue皮肤（移动端默认）时，文本大小与周围的文本相同。	仅在必要时使用小型文本。使用Minerva Neue皮肤（移动端默认）时，文本大小与周围的文本相同。
大型文本，<big>…</big>已经在HTML 5规范中删除，请勿使用。	不要使用<big>大型文本</big>！使用Minerva Neue皮肤（移动端默认）时，文本大小与周围的文本相同。	不要使用大型文本！使用Minerva Neue皮肤（移动端默认）时，文本大小与周围的文本相同。
更改文本大小	{{tl|Resize}}模板提供了更加灵活、无关语义的更改文本尺寸方法。 * 这里将文本尺寸变得{{resize|larger|更大}}； * 也可以变得{{resize|smaller|更小}}； * 或者说，指定一个{{resize|80%|百分比}}； * 设置为周围文本的{{resize|0.8em|几倍}}； * 指定一个{{resize|20px|实际尺寸}}；	{{Resize}}模板提供了更加灵活、无关语义的更改文本尺寸方法。 这里将文本尺寸变得更大； 也可以变得更小； 或者说，指定一个百分比； 设置为周围文本的几倍； 指定一个实际尺寸；
有时我们不想让单词在空格处换行，可以把空格替换为不换行空格（Non-breaking space，字符实体引用为&nbsp;）。也可以用{{Nowrap}}模板，在单词较多时会更方便。	Mr.&nbsp;Smith或400&nbsp;km/h	Mr. Smith或400 km/h
上标与下标	有时候需要用到上下标，比如M<sup>me</sup> Denise、CH<sub>4</sub>。	有时候需要用到上下标，比如Mme Denise、CH4

特殊字符

特殊字符可以使用字符值引用或字符实体引用添加。参见HTML的字符编码获取更多信息。举例来说：À和À都会显示为À（沉音符A）。无法使用百分号编码，它只能在URL里使用。

也可以使用编辑器的“特殊字符”面板添加，或从外部（像SYMBL这样的网站）复制到页面中。

链接和URL

wiki链接

wikitext中，在页面之间生成内部链接的标记就是wiki链接。把需要创建链接的字词用2对西文中括号（[[…]]）括起来就能创建这种链接，链接目标就是以该词作为标题的页面。也就是说，[[鳕鱼贫鸟居]]会显示为鳕鱼贫鸟居。可以使用竖线（|）符号自定义链接的显示文本。举例来说，[[TsanconBYin|必应]]会显示为必应，链接显示的文本为“必应”，而实际上链接到TsanconBYin。

链接至另一wiki条目

• 在页面标题中，标题的首字母会自动大写，下划线（_）在URL中代表空格（可以理解为标题中的空格在数据库中储存为下划线）。因此在链接中，无论首字母的形式或使用空格/下划线，链接目标都是同一个。
• 因此，下面链接指向网址https://wiki.ria.red/wiki/Zth_Plus，是wiki中题为Zth Plus的条目。
• 红链指向还不存在的页面，点击该链接可创建页面。
• 目标为当前页面的链接仅会显示为粗体，没有链接效果。

源代码	显示
[[Zth Plus]]是以前用高版本Minecraft加入服务器的一种手段。	Zth Plus是以前用高版本Minecraft加入服务器的一种手段。
指向本页面的链接“[[Help:Wikitext]]”仅会显示为粗体，没有链接效果。	指向本页面的链接“Help:Wikitext”仅会显示为粗体，没有链接效果。

重命名链接

• 显示文本不同，链接目标不变。
• 链接目标放在竖线前，显示文本放在竖线后。

源代码	显示
在服务器支持多版本加入前，很多人使用[[Zth Plus|这个工具]]来加入服务器。	在服务器支持多版本加入前，很多人使用这个工具来加入服务器。

自动重命名链接

一些情况下，在链接源代码后加入竖线（|）可以自动重命名链接。在保存编辑后，这些链接的源代码会自动替换为标准的重命名格式。

描述	输入	显示
自动移除括号里的内容	[[奈落洲 (新洲)|]]	奈落洲
自动移除逗号后的内容，中文很少用。	[[Seattle, Washington|]]	Seattle
自动移除命名空间	[[Project:可视化编辑器|]]	可视化编辑器
全部移除	[[Module:Sandbox (REV)|]]	Sandbox
章节链接中不可使用自动重命名	[[Project:收录范围#聚落|]]	[[Project:收录范围#聚落|]]

链接到页面的特定章节

• 井号（#）后的部分必须匹配目标页面的章节标题之一。匹配项必须在拼写、大小写和标点等方面准确无误。目标不存在的链接依然可用，它们指向页面顶部。
• 与一般内链一样，可以使用竖线（|）更改链接显示文本。
• 如果章节有相同的标题，在链接的标题部分后添加数字（除了目标是首个使用此名称的章节）就能将目标更改为特定位置的章节。#示例 3的目标是第3个以“示例”作为标题的章节。

输入	显示
链接到其他页面的某个章节：[[Template:Plainlist#使用]]	链接到其他页面的某个章节：Template:Plainlist#使用
链接到本页面的其他一个章节：[[#链接和URL]]；相同链接但移除了井号：[[#链接和URL|链接和URL]]。	链接到本页面的其他一个章节：#链接和URL。相同链接但移除了井号：链接和URL。
改变了显示文本的章节链接：[[Template:Plainlist#使用|Plainlist模板的使用方式]]	改变了显示文本的章节链接：Plainlist模板的使用方式

使用链接创建页面

创建页面时：

1. 在其他相关页面创建到新页面的链接；
2. 保存更改；
3. 点击刚刚创建的链接，开始编写新页面。

不推荐创建没有指向该页面的链接的页面，这样读者就只能通过搜索或找网址来找到页面了。

描述	输入	显示
以不存在的页面作为目标的链接是红色的。	还不存在关于[[鱼子的玩家观察手记3]]的条目。	还不存在关于鱼子的玩家观察手记3的条目。

重定向

重定向是将访问一个页面的读者转移到另一个页面的操作（比如北溟会重定向到北溟神社）。在页面顶部放置像#REDIRECT [[目标页面]]或#重定向 [[目标页面]]这样的指令来创建重定向。也可以重定向到页面的特定章节，比如#REDIRECT [[抹岚#历史]]会指向条目“抹岚”的“历史”一节（如果该章节存在）。

描述	源代码
重定向到页面	#REDIRECT [[抹岚]]
重定向到特定章节	#REDIRECT [[抹岚#历史]]

链接到其他命名空间

在设置目标时使用页面全名就行了。

输入	显示
参见[[Project:收录范围]]。	参见Project:收录范围。

跨wiki链接

跨wiki链接可以快速添加指向常用网站的链接。此功能由Extension:Interwiki扩展实现（其实这就是个跨wiki链接）。虽然叫跨wiki链接，但其实可以支持所有有固定网址格式的站点。

跨wiki链接也是在第一个冒号（:）处将设置的链接目标切开：前面是跨wiki前缀，指示链接指向哪个站点；后面的是那个网站上具体的页面。

跨wiki前缀由wiki自行设定，站点的跨wiki表列出了所有前缀所代表的站点。

跨wiki链接的语法与普通内链相似，都是使用两对中括号。

普通跨wiki链接

描述	输入	显示
简单链接	[[mcwiki:草方块]]	mcwiki:草方块
无前缀	[[mcwiki:草方块|]]	草方块
设置显示文本	[[mcwiki:草方块|Minecraft Wiki中的“草方块”]]	Minecraft Wiki中的“草方块”
甚至链接到别的语言	[[mcwiki:en:Grass_Block]]	mcwiki:en:Grass_Block

外部链接

wikitext中，一对中括号代表外链。与内链不同，外链用空格（内链是竖线 |）分隔链接目标和显示文本。

链接必须以受支持的协议打头：https://（优先使用）和http://受所有浏览器支持；irc://、ircs://、ftp://、news://、mailto:与gopher://需要安装插件或外部应用。链接暂时不支持IPv6地址。

描述	输入	显示
默认外链后面会跟着外链图标	[https://ria.red RIA官网]	RIA官网
编号外链 会在页面中编号，你不会用这个的。	[https://ria.red]	[1]
自由链接 使用<nowiki>…</nowiki>保持未链接状态。	https://ria.red	https://ria.red
没有图标的外链，不常用	<span class="plainlinks">[https://ria.red RIA官网]</span>	RIA官网

杂项

媒体链接

直接链接到文件（不是wiki分配给文件的页面）可以使用媒体链接。

输入	显示
[[Media:Example.png]]	Media:Example.png

直接链接到编辑模式

使用一些技巧可以快速创建页面编辑链接。

输入	显示
[{{fullurl:帮助:Wikitext|action=edit 编辑本页}}]	编辑本页
[[Special:EditPage/帮助:Wikitext|编辑本页]]	编辑本页

图像

只能使用上传到wiki里的图像，可以在文件列表中寻找已上传的图像。

这里应该有个更进一步的帮助页面。

输入	显示	注释
图像名，单词“thumb”和描述： [[File:Example.png|thumb|示例图像]]	图像名，单词“thumb”和描述： 示例图像	“thumb”标签让图像可以自动放大，图像会浮动在页面右边。 图像右下角有一个放大图标。 添加替代文本的信息见下。 这是适用于绝大多数图像的基本语法。也就是说，它如果看起来可以，就不用改了。
一张图像：[[File:Material Design icon Aunst merge.svg]]	一张图像：	只添加图像名的话，图像会放在文本中，如果空间不够的话会扩展到下一行中。 只有很小的图像（也许高度不大于文本高度的1.25倍）才有机会嵌入在文本中。 嵌入图像会影响文本的垂直格式。
添加替代文本：[[File:Material Design icon Aunst merge.svg|alt=代表合并的图像，左侧两个紫色正方形通过线连接到右侧的蓝色圆形]]	添加替代文本：	替代文本会在图像无法加载时显示。浏览器以纯文本模式显示页面时也会显示替代文本。设备在朗读页面时也会读出替代文本。你应该为图像设置替代文本。
带链接：[[File:Material Design icon Aunst merge.svg|link=Project:首页]]	带链接：	一般来说，点击图像会跳转到文件页面，而左边的图像是链接到Project:首页的，可以使用这种方法设置图像链接目标。如果设置为link=的话，点击图像就不会跳转了。