跳到正文
编写
登录

Wikitext编写教程:修订间差异

更多
SpringMoon​(留言 | 贡献)
小 对编辑标题的格式的介绍进行了修正
迷雾样式迁移​(留言 | 贡献)
按新大纲重组编写指南、三类标准页与全模板说明;修复可选信息行结构
 
第1行: 第1行:
= WikiText编写教程:从入门到精通 =
Wikitext 是 MediaWiki 源代码编辑器使用的标记语法。下方给出实际效果与可复制写法;本站模板的名称和参数见 [[模板说明]]。


WikiText是MediaWiki软件(如维基百科)的标记语言,它允许用户通过简单的文本标记来创建丰富的网页内容。这里将全面介绍WikiText的编写方法,帮助各位编写者快速了解这种编写语言
== 标题与段落 ==
页面名称已经是主标题,正文从二级标题开始;两侧等号数量必须相同。空行分隔段落。
<div class="mc-example-preview">
== 小节标题 ==
第一段正文。


== 1. 基础格式 ==
第二段正文。
=== 子标题 ===
在小节下继续细分。
</div>
<div class="mc-example-source"><pre>== 小节标题 ==
第一段正文。


=== 1.1 标题和段落 ===
第二段正文。
=== 子标题 ===
在小节下继续细分。</pre></div>


WikiText使用等号(=)来创建标题,等号的数量表示标题级别:


<pre>
== 文字与列表 ==
=一级标题
两个英文单引号表示斜体,三个表示粗体。无序列表用星号,有序列表用井号,连续的列表项之间不要插入空行。
==二级标题
<div class="mc-example-preview">
===三级标题
这是 '''粗体''',这是 ''斜体''。
====四级标题
=====五级标题
======六级标题
</pre>


'''示例效果:'''
= 一级标题 =
== 二级标题 ==
=== 三级标题 ===
==== 四级标题 ====
===== 五级标题 =====
====== 六级标题 ======
段落之间使用空行分隔:
<pre>
这是第一个段落。
这是第二个段落。
</pre>
=== 1.2 文本格式 ===
<pre>
''斜体文字''
'''粗体文字'''
'''''粗斜体文字'''''
<u>下划线文字</u>
<s>删除线文字</s>
<code>代码格式</code>
<pre>预格式化文本块</pre>
</pre>
'''示例效果:'''
* ''斜体文字''
* '''粗体文字'''
* '''''粗斜体文字'''''
* <u>下划线文字</u>
* <s>删除线文字</s>
* <code>代码格式</code>
= 2. 链接和URL =
== 2.1 内部链接 ==
<pre>
[[页面名称]]
[[页面名称|显示文本]]
</pre>
'''示例:'''
* [[首页]]
* [[首页|返回首页]]
== 2.2 外部链接 ==
<pre>
[https://www.example.com]
[https://www.example.com 示例网站]
</pre>
'''示例效果:'''
* [https://www.mistarg.cn/]
* [https://www.mistarg.cn/ 迷雾站]
== 2.3 分类和文件链接 ==
<pre>
[[Category:分类名称]]
[[File:文件名.jpg]]
[[File:文件名.jpg|thumb|200px|图片说明]]
</pre>
= 3. 列表 =
== 3.1 无序列表 ==
<pre>
* 第一项
* 第一项
* 第二项
* 第二项
** 第二项的子项
* 第三项
</pre>


'''示例效果:'''
# 第一步
# 第二步
</div>
<div class="mc-example-source"><pre>这是 '''粗体''',这是 ''斜体''。
 
* 第一项
* 第一项
* 第二项
* 第二项
** 第二项的子项
* 第三项


== 3.2 有序列表 ==
# 第一步
<pre>
# 第二步</pre></div>
# 第一项
# 第二项
## 第二项的子项
# 第三项
</pre>'''示例效果:'''
# 第一项
# 第二项
## 第二项的子项
# 第三项


== 3.3 定义列表 ==
<pre>
;术语1
:定义1
;术语2
:定义2
</pre>


'''示例效果:'''
== 链接与分类 ==
;术语1
内部链接写页面名称;外部链接写完整网址和显示文字。
:定义1
<div class="mc-example-preview">
;术语2
[[首页]] · [[ARG档案|查看已有档案]] · [https://www.mediawiki.org/wiki/Help:Formatting MediaWiki 格式帮助]
:定义2
</div>
<div class="mc-example-source"><pre>[[首页]] · [[ARG档案|查看已有档案]] · [https://www.mediawiki.org/wiki/Help:Formatting MediaWiki 格式帮助]</pre></div>


= 4. 表格 =
给文章添加分类时使用 <code><nowiki>[[分类:实际分类名]]</nowiki></code>;只想链接分类页面而不把文章加入分类时,在前面加冒号:<code><nowiki>[[:分类:实际分类名]]</nowiki></code>。先确认已有分类,不把教学示例归入真实项目档案。


== 4.1 基本表格 ==
== 图片与图库 ==
<pre>
文件名必须与已上传文件一致。缩略图可进入文件描述页,说明中写清内容要点;来源与版权在文件描述页维护。
{| class="wikitable"
<div class="mc-example-preview">
! 表头1
[[文件:Sudoku.webp|缩略图|居中|300px|数独图片,来源与版权见文件描述页。]]
! 表头2
</div>
|-
<div class="mc-example-source"><pre>[[文件:Sudoku.webp|缩略图|居中|300px|数独图片,来源与版权见文件描述页。]]</pre></div>
| 单元格1
| 单元格2
|-
| 单元格3
| 单元格4
|}
</pre>


'''示例效果:'''
<div class="mc-example-preview">
<gallery widths="180" heights="140">
Sudoku.webp|现有文件的图示与说明
凯撒密码加密图例.png|另一张现有图片;来源见文件描述页
</gallery>
</div>
<div class="mc-example-source"><pre>&lt;gallery widths="180" heights="140"&gt;
Sudoku.webp|现有文件的图示与说明
凯撒密码加密图例.png|另一张现有图片;来源见文件描述页
&lt;/gallery&gt;</pre></div>


{| class="wikitable"
! 表头1
! 表头2
|-
| 单元格1
| 单元格2
|-
| 单元格3
| 单元格4
|}


== 4.2 复杂表格 ==
== 表格 ==
<pre>
表格以 <code><nowiki>{|</nowiki></code> 开始、<code><nowiki>|}</nowiki></code> 结束;<code><nowiki>|-</nowiki></code> 表示换行,<code>!</code> 表示表头,<code><nowiki>||</nowiki></code> 分隔单元格。
<div class="mc-example-preview">
{| class="wikitable"
{| class="wikitable"
! 姓名 !! 年龄 !! 职业
! 次序 !! 十六进制字节 !! 十进制值 !! ASCII 字符
|-
| 张三 || 25 || 工程师
|-
|-
| colspan="2" | 李四,30岁 || 医生
| 1 || 66 || 102 || f
|-
|-
| 王五 || rowspan="2" | 40+ || 教师
| 2 || 6F || 111 || o
|-
|-
| 赵六 || 律师
| 3 || 6F || 111 || o
|}
|}
</pre>
</div>
 
<div class="mc-example-source"><pre>{| class="wikitable"
'''示例效果:'''
! 次序 !! 十六进制字节 !! 十进制值 !! ASCII 字符
 
{| class="wikitable"
! 姓名 !! 年龄 !! 职业
|-
| 张三 || 25 || 工程师
|-
|-
| colspan="2" | 李四,30岁 || 医生
| 1 || 66 || 102 || f
|-
|-
| 王五 || rowspan="2" | 40+ || 教师
| 2 || 6F || 111 || o
|-
|-
| 赵六 || 律师
| 3 || 6F || 111 || o
|}
|}</pre></div>
 
= 5. 模板 =
模板是预定义的内容块,可以在多个页面中重复使用。
 
== 5.1 基本模板使用 ==
<pre>
{{模板名}}
{{模板名|参数1=值1|参数2=值2}}
</pre>
 
== 5.2 常用模板示例 ==
<pre>
{{Infobox 人物
|姓名=张三
|出生日期={{birth date|1990|1|1}}
|职业=工程师
}}
</pre>
 
== 5.3创建模板 ==
根据5.1在页面中使用要创建的模板后,保存退出编辑状态可以看到模板为红色字体,点击进入即可创建对应模板.


== 5.4创建变量 ==
在模板中使用以下内容即可创建变量
<pre>
{{{变量名称}}}
</pre>


== 5.4示例模板以及页面 ==
== 模板 ==
(少女祈祷中...)
双层大括号调用模板,等号左侧是参数名、右侧是内容。可选参数留空时,效果由模板定义。本站“信息提示”的用法如下:
<div class="mc-example-preview">
{{信息提示|类型=提示|标题=资料范围|内容=本文只记录已经核实的内容。没有来源支持的推测应另行说明,不作为已证实结论。}}
</div>
<div class="mc-example-source"><pre>{{信息提示|类型=提示|标题=资料范围|内容=本文只记录已经核实的内容。没有来源支持的推测应另行说明,不作为已证实结论。}}</pre></div>


= 6. 高级功能 =
模板参数中的普通竖线用 <code><nowiki>{{!}}</nowiki></code>;链接中的竖线保持原样。含等号的文本要写成命名参数,或显式写 <code>1=</code>。需要新模板时先查看 [[模板说明]],避免重复创建。


== 6.1 魔术字(Magic Words) ==
== 原始文字与代码 ==
魔术字是系统预定义的变量或函数,用于显示动态内容:
行内短代码使用 <code>&lt;code&gt;</code>;多行原始文字使用 <code>&lt;pre&gt;</code>;显示 Wikitext 标记本身使用 <code>&lt;nowiki&gt;</code>。下面的复制代码包含完整 pre 标签:
<div class="mc-example-preview">
<pre>value = "666F6F"
result = bytes.fromhex(value).decode("ascii")
print(result)
# 输出:foo</pre>
</div>
<div class="mc-example-source"><pre>&lt;pre&gt;value = "666F6F"
result = bytes.fromhex(value).decode("ascii")
print(result)
# 输出:foo&lt;/pre&gt;</pre></div>


<pre>
{{CURRENTYEAR}} - 当前年份
{{PAGENAME}} - 当前页面名
{{#if:条件|为真时显示|为假时显示}}
</pre>


'''示例:'''
== 引用与注释 ==
* 今年是{{CURRENTYEAR}}年
文献引用使用 ref,正文末尾放 references。相同的引用名复用同一条来源。
* 当前页面是{{PAGENAME}}
<div class="mc-example-preview">
本例可以用规范中的测试向量复核。<ref name="demo-hex">{{引文信息|标题=RFC 4648|网址=https://www.rfc-editor.org/rfc/rfc4648.html#section-10|作者=Simon Josefsson|定位=第 10 节:测试向量}}</ref>
同一来源再次使用时不重复录入。<ref name="demo-hex" />
</div>
<div class="mc-example-source"><pre>本例可以用规范中的测试向量复核。&lt;ref name="demo-hex"&gt;{{引文信息|标题=RFC 4648|网址=https://www.rfc-editor.org/rfc/rfc4648.html#section-10|作者=Simon Josefsson|定位=第 10 节:测试向量}}&lt;/ref&gt;
同一来源再次使用时不重复录入。&lt;ref name="demo-hex" /&gt;</pre></div>


== 6.2 解析器函数 ==
<div class="mc-example-source"><pre>&lt;references /&gt;</pre></div>
<pre>
{{#expr:1+1}} - 计算表达式
{{#time:Y-m-d|2023-01-01}} - 格式化时间
{{#switch:值|情况1=结果1|情况2=结果2|默认结果}}
</pre>


'''示例:'''
<references />
* 1+1={{#expr:1+1}}


== 6.3 HTML标签 ==
译注可以另设分组:
WikiText支持部分HTML标签:
<div class="mc-example-preview">
这里给出正文。<ref group="注">这里写编写者的译注或术语说明;此句仅演示注释格式。</ref>
<references group="注" />
</div>
<div class="mc-example-source"><pre>这里给出正文。&lt;ref group="注"&gt;这里写编写者的译注或术语说明;此句仅演示注释格式。&lt;/ref&gt;
&lt;references group="注" /&gt;</pre></div>


<pre>
<div style="color:red;">红色文字</div>
<span class="highlight">高亮文字</span>
<references/> - 显示引用列表
</pre>


<div style="color:red;">红色文字</div>
[[编写指南|返回编写指南]] · [[模板说明|全部模板说明]]
<references/> - 显示引用列表

2026年10月13日 (二) 15:57的最新版本

Wikitext 是 MediaWiki 源代码编辑器使用的标记语法。下方给出实际效果与可复制写法;本站模板的名称和参数见 模板说明。

标题与段落

页面名称已经是主标题,正文从二级标题开始;两侧等号数量必须相同。空行分隔段落。

小节标题

第一段正文。

第二段正文。

子标题

在小节下继续细分。

== 小节标题 ==
第一段正文。

第二段正文。
=== 子标题 ===
在小节下继续细分。


文字与列表

两个英文单引号表示斜体,三个表示粗体。无序列表用星号,有序列表用井号,连续的列表项之间不要插入空行。

这是 粗体,这是 斜体。

  • 第一项
  • 第二项
  1. 第一步
  2. 第二步
这是 '''粗体''',这是 ''斜体''。

* 第一项
* 第二项

# 第一步
# 第二步


链接与分类

内部链接写页面名称;外部链接写完整网址和显示文字。

[[首页]] · [[ARG档案|查看已有档案]] · [https://www.mediawiki.org/wiki/Help:Formatting MediaWiki 格式帮助]

给文章添加分类时使用 [[分类:实际分类名]];只想链接分类页面而不把文章加入分类时,在前面加冒号:[[:分类:实际分类名]]。先确认已有分类,不把教学示例归入真实项目档案。

图片与图库

文件名必须与已上传文件一致。缩略图可进入文件描述页,说明中写清内容要点;来源与版权在文件描述页维护。

数独图片,来源与版权见文件描述页。
[[文件:Sudoku.webp|缩略图|居中|300px|数独图片,来源与版权见文件描述页。]]
<gallery widths="180" heights="140">
Sudoku.webp|现有文件的图示与说明
凯撒密码加密图例.png|另一张现有图片;来源见文件描述页
</gallery>


表格

表格以 {| 开始、|} 结束;|- 表示换行,! 表示表头,|| 分隔单元格。

次序 十六进制字节 十进制值 ASCII 字符
1 66 102 f
2 6F 111 o
3 6F 111 o
{| class="wikitable"
! 次序 !! 十六进制字节 !! 十进制值 !! ASCII 字符
|-
| 1 || 66 || 102 || f
|-
| 2 || 6F || 111 || o
|-
| 3 || 6F || 111 || o
|}


模板

双层大括号调用模板,等号左侧是参数名、右侧是内容。可选参数留空时,效果由模板定义。本站“信息提示”的用法如下:

提示
资料范围

本文只记录已经核实的内容。没有来源支持的推测应另行说明,不作为已证实结论。

{{信息提示|类型=提示|标题=资料范围|内容=本文只记录已经核实的内容。没有来源支持的推测应另行说明,不作为已证实结论。}}

模板参数中的普通竖线用 {{!}};链接中的竖线保持原样。含等号的文本要写成命名参数,或显式写 1=。需要新模板时先查看 模板说明,避免重复创建。

原始文字与代码

行内短代码使用 <code>;多行原始文字使用 <pre>;显示 Wikitext 标记本身使用 <nowiki>。下面的复制代码包含完整 pre 标签:

value = "666F6F"
result = bytes.fromhex(value).decode("ascii")
print(result)
# 输出:foo
<pre>value = "666F6F"
result = bytes.fromhex(value).decode("ascii")
print(result)
# 输出:foo</pre>


引用与注释

文献引用使用 ref,正文末尾放 references。相同的引用名复用同一条来源。

本例可以用规范中的测试向量复核。[1] 同一来源再次使用时不重复录入。[1]

本例可以用规范中的测试向量复核。<ref name="demo-hex">{{引文信息|标题=RFC 4648|网址=https://www.rfc-editor.org/rfc/rfc4648.html#section-10|作者=Simon Josefsson|定位=第 10 节:测试向量}}</ref>
同一来源再次使用时不重复录入。<ref name="demo-hex" />
<references />
  1. ↑ 1.0 1.1 Simon Josefsson:RFC 4648,第 10 节:测试向量

译注可以另设分组:

这里给出正文。[注 1]

  1. ↑ 这里写编写者的译注或术语说明;此句仅演示注释格式。
这里给出正文。<ref group="注">这里写编写者的译注或术语说明;此句仅演示注释格式。</ref>
<references group="注" />


返回编写指南 · 全部模板说明

迷雾 Wiki
搜索迷雾 Wiki
阅读设置