在wikitext中,你可以使用一些HTML标签。这些HTML标签会被解析。需要注意的是,不是所有的HTML标签都支持,如果使用不支持的HTML标签,则会直接呈现在页面结果中。
基本用法
HTML标签的语法并不复杂,直接看几个例子就可以明白。标签可以包含一些文本,以给文本应用效果。少数标签是自我闭合的。
<span>...</span>
是最常用的标签。通常来说,你需要为这个标签添加style、title、lang等属性以实现对应的功能。
<span style="color: red">这是红色的文字。</span>
这是红色的文字。
<span style="border: 1px red solid">这个文字具有红框。</span>
这个文字具有红框。
<span title="这是提示文字!">在电脑上阅读此页面时,鼠标悬浮在上面可以显示提示文本。</span>
在电脑上阅读此页面时,鼠标悬浮在上面可以显示提示文本。
<span lang="en">This text is in English</span>
This text is in English
你可以使用HTML标签来使用<b>加粗</b>、<i>斜体</i>、<u>下划线</u>、<s>删除线</s>等。
你可以使用HTML标签来使用加粗、斜体、下划线、删除线等。
MediaWiki不支持的标签,<a>会被直接显示</a>。
MediaWiki不支持的标签,<a>会被直接显示</a>。
这是一个自我闭合的标签<br />可以在代码内换行。
这是一个自我闭合的标签
可以在代码内换行。
在前面的四个例子中,我们给HTML标签设置了属性,其中style属性是最常用的,表示样式,参见Help:CSS。第四个例子中,可以看到一些标签自带样式,其中加粗和斜体也可以使用wikitext实现,无需借助HTML。
允许的HTML标签
MediaWiki的文本解析器只允许以下这些标签,其中的部分标签都有自己的用途。这里列举出来的标签并不包含扩展标签和文本解析标签。
简称,例如<abbr title="Application Program Interface">API</abbr>、<abbr title="Regular Expression">regex</abbr>。
简称,例如API、regex。
<b>引起注意的加粗文字。</b>
引起注意的加粗文字。
<bdi dir=rtl>双向文本。</bdi>
双向文本。
<bdo dir=rtl>双向覆盖的文本。</bdo>
双向覆盖的文本。
<blockquote>块状引用的文本。</blockquote>
块状引用的文本。
换<br>行。
换
行。
<cite>引用的文本。</cite>
引用的文本。
内联的计算机代码,如<code>System.out.println("Hello world!");</code>
内联的计算机代码,如System.out.println("Hello world!");
<data value="Value">数据。</data>
数据。
<del>删除的文本。</del>
删除的文本。
<dfn>定义。</dfn>
定义。
<div>将内容分成</div> <div>多个部分</div>
<dl> <dt>定义列表的第一项</dt> <dd>第一项的细节。</dd> <dt>定义列表的第二项</dt> <dd>第二项的细节。</dd> </dl>
- 定义列表的第一项
- 第一项的细节。
- 定义列表的第二项
- 第二项的细节。
这是<em>被强调的内容</em>。
这是被强调的内容。
<h1>一级标题</h1> <h2>二级标题</h2> <h3>三级标题</h3> <h4>四级标题</h4> <h5>五级标题</h5> <h6>六级标题</h6>
横线 <hr> 将文本隔开。
横线
将文本隔开。
<i>斜体文本。</i>
斜体文本。
表示<ins>被插入</ins>的文本。
表示被插入的文本。
<kbd>键盘输入</kbd>。
键盘输入。
<mark>将文本高亮。</mark>
将文本高亮。
<ol> <li>这是一个有序列表。</li> <li>有序列表的第二项。</li> </ol>
- 这是一个有序列表。
- 有序列表的第二项。
<p>这是一个段落。</p> <p>这是另一个段落。</p>
这是一个段落。
这是另一个段落。
<pre>预格式化的文本</pre>
预格式化的文本。
行内<q>引用</q>的内容。
行内引用
的内容。
ruby系列标签,例如化合价:<ruby>Mg<rp>(</rp><rt>+2</rt><rp>)</rp></ruby>。
ruby系列标签,例如化合价:Mg。
<s>被删除的文本。</s>
被删除的文本。
<samp>样例输出。</samp>
样例输出。
<small>小型文本,通常用于旁注。</small>
小型文本,通常用于旁注。
这只是一个简单的<span>文本范围</span>。
这只是一个简单的文本范围。
着重<strong>强调</strong>的内容。
着重强调的内容。
这是<sub>下标</sub>。
这是下标。
这是<sup>上标</sup>。
这是上标。
<table border="1"> <caption>caption表示表格标题</caption> <tr><th>th</th><th>表示</th><th>表头</th></tr> <tr><td>td</td><td>表示</td><td>单元格</td></tr> </table>
th | 表示 | 表头 |
---|---|---|
td | 表示 | 单元格 |
<time>日期/时间。</time>
给文本添加<u>不明显强调</u>。
给文本添加不明显强调。
<ul> <li>这是一个</li> <li>无序列表。</li> </ul>
- 这是一个
- 无序列表。
<var>变量</var>也会用斜体显示。
变量也会用斜体显示。
可以<wbr>换行的地方。
可以
此外,以下标签是弃用的,不应该使用:
<big>
<center>
<font>
<rb>
<rtc>
<strike>
<tt>
特殊的HTML语法
注释
你可以在wikitext中添加注释,和HTML的语法一样。注释只会保留在wikitext中,呈现的HTML的源代码不会有注释。
<!-- 这是一个注释。 -->
<pre>
标签
和其他HTML标签不同的是,<pre>
标签虽然可以设置大多数属性、样式,但是其内容不会被解析,而是照原样输出。例如:
<pre>'''[[wikitext标记]]'''、<ins>HTML</ins>都会失效。</pre>
'''[[wikitext标记]]'''、<ins>HTML</ins>都会失效。
但是,<pre>...</pre>
中的内容依然支持HTML实体、<nowiki>...</nowiki>
,字词转换不会进行,但是如果含有转换标记,则会进行转换。
特殊的标签
<nowiki>
、<includeonly>
、<onlyinclude>
和<noinclude>
属于解析标签,用于辅助文本解析器,并不是常规的HTML标签。此外,MediaWiki的许多扩展程序也允许在代码内加入一些非HTML的标签,如<syntaxhighlight>
和<langconvert>
,这一类标签称为扩展标签。