Help:Wikitext

This help page is a how-to guide. It explains concepts or processes used by the Wikipedia community. It is not one of Wikipedia's policies or guidelines, and may reflect varying levels of consensus.

Shortcuts H:WT H:MARKUP H:WIKICODE

The markup language called wikitext, also known as wiki markup or wikicode, consists of the syntax and keywords used by the MediaWiki software to format a page. (Note the lowercase spelling of these terms.^[a]) To learn how to see this hypertext markup, and to save an edit, see Help:Editing. Generally, coding can be copied and pasted, without writing new code. There is a short list of markup and tips at Help:Cheatsheet.

In addition to wikitext, some HTML elements are also allowed for presentation formatting. See Help:HTML in wikitext for information on this.

Article sections in a page will follow that page's lead or introduction and, if there are four or more, the table of contents.

The = through ====== markup are headings for the sections with which they are associated.

• A single = is styled as the article title and should not be used within an article.
• Headings are styled through CSS and add an [edit] link. See this section for the relevant CSS.
• Four or more headings cause a table of contents to be generated automatically.
• Do not use any markup after the final heading markup – this will either break the heading, or will cause the heading to not be included in an edit summary.

= Heading 1 =
== Heading 2 ==
=== Heading 3 ===
==== Heading 4 ====
===== Heading 5 =====
====== Heading 6 ======

Templates: {{fake heading}} for use in documentation.

The horizontal rule represents a paragraph-level thematic break. Do not use in article content, as rules are used only after main sections, and this is automatic.

----

HTML equivalent: <hr /> (which can be indented, whereas ---- always starts at the left margin.)

When a page has at least four headings, a table of contents (TOC) will automatically appear after the lead and before the first heading. The TOC can be controlled by magic words or templates:

• __FORCETOC__ forces the TOC to appear at the normal location regardless of the number of headings.
• __TOC__ forces the TOC to appear at the point where the magic word is inserted instead of the normal location.
• __NOTOC__ disables the TOC entirely.
• {{TOC limit}} template can be used to control the depth of subsections included in the TOC. This is useful where the TOC is long and unwieldy.
• Category:Wikipedia table of contents templates contains a number of specialized TOC templates.

Line breaks or newlines are used to add whitespace between lines, such as separating paragraphs.

• A line break that is visible in the content is inserted by pressing ↵ Enter twice.
• Pressing ↵ Enter once will place a line break in the markup, but it will not show in the rendered content, except when using list markup.
• Markup such as bold or italics will be terminated at a line break.
• Blank lines within indented wikitext should not be added due to accessibility issues.

A single newline here
has no effect on the layout.

But an empty line starts a new paragraph, 
or ends a list or an indented part.

HTML equivalent: <br> or <br /> can be used to break line layout.

Templates for line breaks:

• {{break}} can add multiple line breaks.
• {{-}} and {{clear}} adds a break with styling, to clear floating elements. Often used to prevent text from flowing next to unrelated tables or images.

Unbulleted list:

• {{plainlist}} and {{unbulleted list}} both create an unbulleted list.

Indentation is most commonly used on talk pages.

Indentation as used on talk pages:
:Each colon at the start of a line
::causes the line to be indented by three more character positions.
:::(The indentation persists
so long as no carriage return or line break is used.)
:::Repeat the indentation at any line break.
::::Use an extra colon for each response.
:::::And so forth ...
::::::And so on ...
{{Outdent|::::::}}The outdent template can give a visual indicator that we're deliberately cancelling the indent (6 levels here)

Templates: {{outdent}}, {{outdent2}}

When there is a need for separating a block of text. This is useful for (as the name says) inserting blocks of quoted (and cited) text.

Normal text
<blockquote>
The '''blockquote''' tag will indent both margins when needed instead of the left margin only as the colon does.
</blockquote>
Normal text

This uses an HTML tag; template {{quote}} results in the same render.

<div class="center" style="width: auto; margin-left: auto; margin-right: auto;">Centered text</div>

Template {{center}} uses the same markup. To center a table, see Help:Table#Centering tables. Please do not use <center>...</center> tags, as it is obsolete.

You can align content in a separate container:

<div style="text-align: right; direction: ltr; margin-left: 1em;">Text on the right</div>

Or; make the text float around it:

<div class="floatright">Text on the right</div>

{{stack|Text on the right}}

Do not leave blank lines between items in a list unless there is a reason to do so, since this causes the MediaWiki software to interpret each item as beginning a new list.

* Item1
* Item2
* Item3
* Item4
** Sub-item 4 a)
*** Sub-item 4 a) 1.
**** Sub-item 4 a) 1. i)
**** Sub-item 4 a) 1. ii)
** Sub-item 4 b)
* Item5

# Item1
# Item2
# Item3
# Item4
## Sub-item 1
### Sub-sub-item
#### Sub-sub-sub-item
## Sub-item 2
# Item5

To list terms and definitions, start a new line with a semicolon (;) followed by the term. Then, type a colon (:) followed by a definition. The format can also be used for other purposes, such as make and models of vehicles, etc.

Description lists (formerly definition lists, and a.k.a. association lists) consist of group names corresponding to values. Group names (terms) are in bold. Values (definitions) are indented. Each group must include one or more definitions. For a single or first value, the : can be placed on the same line after ; – but subsequent values must be placed on separate lines.

Do not use a semicolon (;) simply to bold a line without defining a value using a colon (:). This usage renders invalid HTML5 and creates issues with screen readers. Also, use of a colon to indent (other than for talk page responses) may also render invalid HTML5 and cause accessibility issues per MOS:INDENTGAP.

; Term : Definition1

; Term
: Definition1
: Definition2
: Definition3
: Definition4

HTML equivalent: <dl> <dt>...</dt>, <dd>...</dd> </dl>

Templates: {{defn}}

The MediaWiki software suppresses single newlines and converts lines starting with a space to preformatted text in a dashed box. HTML suppresses multiple spaces. It is often desirable to retain these elements for poems, lyrics, mottoes, oaths and the like. The Poem extension adds HTML-like <poem>...</poem> tags to maintain newlines and spaces. These tags may be used inside other tags such as <blockquote>...</blockquote>; the template {{poemquote}} provides a convenient shorthand. CSS styles may be applied to this tag, e.g.: <poem style="margin-left: 2em;">.

<poem>
In Xanadu did Kubla Khan
  A stately pleasure-dome decree:
Where Alph, the sacred river, ran
  Through caverns measureless to man
Down to a sunless sea.

So twice five miles of fertile ground
  With walls and towers were girdled round:
And there were gardens bright with sinuous rills,
  Where blossomed many an incense-bearing tree;
And here were forests ancient as the hills,
  Enfolding sunny spots of greenery.
</poem>

Poems and their translation can be presented side by side, and the language can be indicated with lang="xx". Following the last side-by-side block, {{Clear|left}} must be used to cancel "float:left;" and to re-establish normal flow. Note that this method does not require a table and its columns to achieve the side-by-side presentation.

Markup

<poem lang="fr" style="float:left;">Frère Jacques, frère Jacques,
Dormez-vous? Dormez-vous?
Sonnez les matines! Sonnez les matines!
Ding, dang, dong. Ding, dang, dong.</poem>
<poem style="margin-left:2em; float:left;">Are you sleeping? Are you sleeping?
Brother John, Brother John,
Morning bells are ringing! Morning bells are ringing!
Ding, dang, dong. Ding, dang, dong.</poem>{{Clear|left}}

Renders as

To ''italicize text'', put two consecutive apostrophes on each side of it.

Three apostrophes each side will '''bold the text'''.

Five consecutive apostrophes on each side (two for italics plus three for bold) produces '''''bold italics'''''.

'''''Italic and bold formatting''''' works correctly only within a single line.

For text as {{smallcaps|small caps}}, use the template {{tl|smallcaps}}.

function <code>int m2()</code> is nice.

<syntaxhighlight lang="cpp">
#include <iostream>
int m2 (int ax, char *p_ax) {
  std::cout <<"Hello World!";
  return 0;
}</syntaxhighlight>

#include <iostream>
int m2 (int ax, char *p_ax) {
  std::cout <<"Hello World!";
  return 0;
}

Use <small>small text</small> only 
when necessary.

To match, for example, the font-size used in an [[Help:Visual file markup#Caption|image caption]], the "small" tag can also be used to 
<small style="font-size:87%;">reduce a text's font-size to 87%</small>.

Better not use <big>big text</big>, unless <small>it's <big>within</big> small</small> text.

Mr. Smith or 400 km/h

Mary {{pad|4.0em}} had a little lamb.

Special characters can often be displayed using numeric character references or character entity references. See Character encodings in HTML for more information. For example, À and À both render À (A-grave). Percent-encoding can't be used, as it works only in URLs.

Diacritic marks, using character entity references.

À Á Â Ã Ä Å Æ

Ç È É Ê Ë

Ì Í Î Ï Ñ

Ò Ó Ô Õ Ö Ø Œ

Ù Ú Û Ü Ÿ ß

à á â ã ä å æ ç

è é ê ë

ì í î ï ñ

ò ó ô õ ö ø œ

ù ú û ü ÿ

Using character entity references.

The <pre>, <nowiki>, and <code> markup tags are also available, for writing "[", "{", "&", "}", "]" for example. These tags prevent these characters from being recognised as wiki markup, which is a possibility in some circumstances.

Using character entity references.

Using character entity references.

WikiHiero is a software extension that renders Egyptian hieroglyphs as PNG images using <hiero> HTML-like tags.

Example:

Markup	Renders as
<hiero>P2</hiero>

• The Manual of Style prefers the <sub> and <sup> formats, for example x<sub>1</sub>. So this should be used under most circumstances.
• The latter methods of sub/superscripting cannot be used in the most general context, as they rely on Unicode support that may not be present on all users' machines.

x<sub>1</sub> x<sub>2</sub> x<sub>3</sub> or

x&#8320; x&#8321; x&#8322; x&#8323; x&#8324;

x&#8325; x&#8326; x&#8327; x&#8328; x&#8329;

x<sup>1</sup> x<sup>2</sup> x<sup>3</sup> or

x&#8304; x&sup1; x&sup2; x&sup3; x&#8308;

x&#8309; x&#8310; x&#8311; x&#8312; x&#8313;

&epsilon;<sub>0</sub> = 8.85 &times; 10<sup>&minus;12</sup> C&sup2; / J m

1 [[hectare]] = 1 E+4 m&sup2;

Invisible and PUA (Private Use Areas) characters should be avoided where possible. When needed, they should both be replaced with their (hexa)decimal code values (as "&#(x)...;"). This renders invisible characters visible, for manual editing, and allows AWB to process pages with PUA characters. The latter should also be tagged with the {{PUA}} template for tracking and future maintenance.

• See also Wikipedia:Mathematical symbols, WikiProject Mathematics and TeX.

• Formulae that include mathematical letters, like x, and operators like × should not use the plain letter x. See math font formatting. For a comprehensive set of symbols, and comparison between <math> tags and the {{math}} template see section TeX vs HTML.

• The <math> tag typesets using LaTeX markup,^[b] which may render as an image or as HTML, depending on environmental settings. The <math> tag is best for the complex formula on its own line in an image format. If you use this tag to put a formula in the line with text, put it in the {{nowrap}} template.

• The {{math}} template uses HTML, and will size-match a serif font, and will also prevent line-wrap. All templates are sensitive to the = sign, so remember to replace = with {{=}} in template input, or start the input with 1=. Use wiki markup '' and ''' inside the {{math}} template, as well as other HTML entities. The {{math}} template is best for typeset formulas in line with the text.

<math>2x \times 4y \div 6z + 8 - \frac {y}{z^2} = 0</math>

{{math|2''x'' &times; 4''y'' &divide; 6''z'' + 8 &minus; {{sfrac|''y''|''z''<sup>2</sup>}} {{=}} 0}}

<math>\sin 2\pi x + \ln e</math>
{{math|sin 2&amp;pi;''x'' + ln ''e''}}

• Using   to prevent line break is not needed; the {{math}} template will prevent line breaks anyway; you can use <br /> if you need an explicit line break inside a formula.

It follows that {{math|''x''<sup>2</sup> &ge; 0}} for real {{mvar|x}}.

• See Help:Displaying a formula for how to use <math>.
• A formula displayed on a line by itself should be indented using <math display=block>...</math>

<math display=block>\sum_{n=0}^\infty \frac{x^n}{n!}</math>

Indenting by using the colon (:) character (i.e. using :<math></math> instead of <math display=block></math>) is discouraged for accessibility reasons.

Wikilinks are used in wikitext markup to produce internal links between pages. You create wikilinks by putting double square brackets around text designating the title of the page you want to link to. Thus, [[Texas]] will be rendered as Texas. Optionally, you can use a vertical bar (|) to customize the link title. For example, typing [[Texas|Lone Star State]] will produce Lone Star State, a link that is displayed as "Lone Star State" but in fact links to Texas.

• Internally, the first letter of the target page is automatically capitalized and spaces are represented as underscores (typing an underscore in the link has the same effect as typing a space, but is not recommended).
• Thus the link hereafter is to the Web address en.wikipedia.org/wiki/Public_transport, which is the Wikipedia article with the name "Public transport". See also Canonicalization.
• A red link is a page that doesn't exist yet; it can be created by clicking on the link.
• A link to its own page will appear only as bold text.

London has [[public transport]].

Link to this page: "[[Help:Wikitext]]" will appear only as bold text.

• Same target, different name.
• The target ("piped") text must be placed first, then the text to be displayed second.

• Simply typing the pipe character | after a link will automatically rename the link in certain circumstances. The next time you open the edit box you will see the expanded piped link. When previewing your edits, you will not see the expanded form until you press Save and Edit again. The same applies to links to sections within the same page.
• See Pipe trick for details.

• Endings are blended into the link.
  • Exception: a trailing apostrophe (') and any characters following the apostrophe are not blended.
• Preferred style is to use this instead of a piped link, if possible.
• Blending can be suppressed by using the <nowiki /> tag, which may be desirable in some instances.

• The part after the hash sign (#) must match a section heading on the page. Matches must be exact in terms of spelling, case, and punctuation. Links to non-existent sections are not broken; they are treated as links to the beginning of the page.
• Include "| link title" to create a stylish (piped) link title.
• If sections have the same title, add a number to link to any but the first. #Example section 3 goes to the third section named "Example section". You can use the pipe and retype the section title to display the text without the # symbol.

• To create a new page:
  1. Create a link to it on some other (related) page.
  2. Save that page.
  3. Click on the link you just made. The new page will open for editing.
• For more information, see starting an article and check out Wikipedia's naming conventions.
• Please do not create a new article without linking to it from at least one other article.

• Redirect one article title to another by placing a directive like the one shown to the right on the first line of the article (such as at a page titled "US").
• It is possible to redirect to a section. For example, a redirect to United States#History will redirect to the History section of the United States page, if it exists.

• The full page name should be included in double square brackets.

After the launch of Wikidata, interlanguage links are now added through it. Links in articles should exist only in special cases, for example when an article in one language has two articles in another language.

• To link to a corresponding page in another language, use the form: [[language code:Foreign title]].
• It is recommended interlanguage links be placed at the very end of the article.
• Interlanguage links are NOT visible within the formatted article, but instead appear as language links on the sidebar (to the left) under the menu section "languages".

• NOTE: To create an inline link (a clickable link within the text) to any foreign language article, see Help:Interlanguage links#Inline interlanguage links and consider the usage notes.

[[es:Plancton]]

[[fr:Plancton]]
[[de:Plankton]]
[[ru:Планктон]]
[[simple:Plankton]]

• Interwiki links link to any page on other wikis. Interwikimedia links link to other Wikimedia wikis.
• Note that interwikimedia links use the internal link style, with double square brackets.
• See Meta-Wiki:Interwiki map for the list of shortcuts; if the site you want to link to is not on the list, use an external link.
• See also Wikipedia:Wikimedia sister projects.

• To put an article in a category, place a link like [[Category:Example]] into the article. As with interlanguage links, placing these links at the end of the article is recommended.
• To link to a category page without putting the article into the category, use a colon prefix (":Category") in the link.

• Single-square brackets indicate an external link. Note the use of a space (not a pipe |) to separate the URL from the link text in a named link. Square brackets may be used as normal punctuation when not linking to anything – [like this].
• A URL must begin with a supported URI scheme: https:// (preferably) and http:// will be supported by all browsers; irc://, ircs://, ftp://, news://, mailto:, and gopher:// will require a plugin or an external application. IPv6 addresses in URLs are currently not supported.
• A URL containing certain characters will display and link incorrectly unless those characters are percent encoded. For example, a space must be replaced by %20. Encoding can be achieved by:

• Use the link button on the enhanced editing toolbar to encode the link; this tool will add the bracket markup and the linked text, which may not always be desirable.
• Or manually encode the URL by replacing these characters:

• Or use the {{urlencode:}} magic word. See Help:Magic words in the MediaWiki documentation for more details.

• See Wikipedia:External links for style issues, and Category:External link file type templates for indicating the file type of an external link with an icon.

• To include links to non-image uploads such as sounds, use a "media" link. For images, see next section.
• Some uploaded sounds are listed at Commons:Sound.

• These create links that directly go to the edit or view source tab. For example, to create links to the edit tab for this page, either of the following works:

• Linking to a page with a title containing words that are usually italicized, such as the Hindenburg disaster article.

Musical notation is added by using the <score>...</score> extension HTML-like tag. For example:

Markup	Renders as
<score>\relative c' { fis d fis a d f e d c cis d e a g f ees }</score>

Only images that have been uploaded to Wikipedia or Wikimedia Commons can be used. To upload images, use the Commons upload wizard for photos you have taken, and the Wikipedia upload page if there may be copyright issues. You can find the uploaded image on the image list.

See the Wikipedia's image use policy for the policy used on Wikipedia.

For further help on images, including some more versatile abilities, see the picture tutorial and extended image syntax.

What you type	What it looks like	Notes
The image name, the word thumb then the caption : [[File:wiki.png|thumb|Wikipedia logo]]	The image name, the word thumb then the caption :	The thumb tag automatically allows the image to be enlarged and positions it (floats) automatically to the right of the page. An enlarge icon is placed in the lower right corner. See note below about adding an alt tag This is the basic markup for most images
A picture: [[File:wiki.png]]	A picture:	The picture name alone places the image in the text, or on the next line if there is insufficient space. Embedding the image in the text is only possible for very small images. Embedding the image will affect the vertical formatting of text.
With alternative text: [[File:wiki.png|alt=Puzzle globe logo]]	With alternative text:	Alternative text, used when the image is unavailable or when the image is loaded in a text-only browser, or when spoken aloud, is strongly encouraged. See Alternative text for images for help on choosing it.
With link: [[File:wiki.png|link=Wikipedia]]	With link:	The link directs to the Wikipedia page, Wikipedia, instead of the image file page.
Forced to the centre of the page using the ''frame'' tag (attribute), a ''centre'' tag and a caption: [[File:wiki.png|frame|centre|alt=Puzzle globe|Wikipedia logo]]	Forced to the centre of the page using the frame tag (attribute), a centre tag and a caption:	The frame tag automatically floats the image right. The frame tag is only of use with very small images or ones using the px tag The attributes left, center or centre override this, and places the image to the left or the centre of the page. The last parameter is the caption that appears below the image.
Forced to the left side of the page using the ''thumb'' attribute, the ''left'' attribute and a caption: [[File:wiki.png|thumb|left|alt=Puzzle globe|Wikipedia logo]]	Forced to the left side of the page using the thumb attribute, the left attribute and a caption:	The thumb tag automatically floats the image right. An enlarge icon is placed in the lower right corner. The attributes left, center or centre override this, and places the image to the left or the centre of the page.
Forced to the right side of the page ''without'' a caption: [[File:wiki.png|right|Wikipedia encyclopedia]]	Forced to the right side of the page without a caption:	Captions are only displayed when the thumb or frame attributes are present The picture tutorial explains more options.
A picture resized to 50 pixels... [[File:wiki.png|50 px|Wikipedia encyclopedia]]	A picture resized to 50 pixels width...	The picture tutorial explains more options. Sizing in pixels is deprecated and should be used very sparingly. There is an upright attribute that should be used instead. These tags are optimised for both laptop and mobile phone screens.
Linking directly to the description page of an image: [[:File:wiki.png]]	Linking directly to the description page of an image: File:wiki.png	Clicking on an image displayed normally on a page also leads to the description page.
Linking directly to an image without displaying it: [[Media:wiki.png|Image of jigsaw globe]]	Linking directly to an image without displaying it: Image of jigsaw globe	To include links to images shown as links instead of drawn on the page, use a "media" link.
Example: <div style="display: inline; width: 220px; float: right;"> [[File:wiki.png|50 px|Wikipedia encyclopedia]][[File:wiki.png|50 px]] </div>	Example:	Using the span or div elements to separate images from text (note that this may allow images to cover text).
Example: {| style="text-align: right;" |- | [[File:wiki.png|50 px]] |- | [[File:wiki.png|50 px]] |- | [[File:wiki.png|50 px]] |}	Example:	Using wiki markup to make a table in which to place a vertical column of images (this helps edit links match headers, especially in Firefox browsers).

There are two ways to build tables:

• Using specific wiki markup: (see Help:Table).
• Using HTML elements: <table>, <tr>, <td> or <th>.

Use {{colbegin}} and {{colend}} templates to produce columns.

Making a reference citing a printed or online source can be accomplished by using the <ref> wiki markup tags. Inside these tags details about the reference are added.

Details about the citation can be provided using a structure provided by various templates; the table below lists some typical citation components.

Examples for templates: {{pad|...}}, {{math|...}}, {{as of|...}}, {{edit}}

Templates are segments of wiki markup that are meant to be copied automatically ("transcluded") into a page. They are specified by putting the template's name in {{double braces}}. Most templates are pages in the Template namespace, but it is possible to transclude mainspace pages (articles) by using {{:colon and double braces}}.

There are three pairs of tags that can be used in wikitext to control how transclusion affects parts of a template or article. They determine whether or not wikitext renders, either in its own article, which we will call "here", or in another article where it is transcluded, which we will call "there".

• <noinclude>: the content will not be rendered there. These tags have no effect here.
• <includeonly>: the content will render only there, and will not render here (like invisible ink made visible by means of transclusion).
• <onlyinclude>: the content will render here and will render there, but it will only render there what is between these tags.

There can be several such section "elements". Also, they can be nested. All possible renderings are achievable. For example, to render there one or more sections of the page here use <onlyinclude> tags. To append text there, wrap the addition in <includeonly> tags before, within, or after the section. To omit portions of the section, nest <noinclude> tags within it.

If a page is transcluded without transclusion markup, it may cause an unintentional categorization. Any page transcluding it will contain the same category as the original page. Wrap the category markup with <noinclude> tags to prevent incorrect categorization. Some templates take parameters, as well, which you separate with the pipe character |.

{{Transclusion demo}}

{{Help:Transclusion demo}}

This template takes two parameters,
and creates underlined text with a
hover box for many modern browsers
supporting CSS:

{{Tooltip|Hover your mouse over this text
|This is the hover text}}

Go to this page to see the Tooltip
template itself: {{tl|Tooltip}}

These are likely to be helpful on talk and project pages.

• The tilde character (~) is used when signing a comment on a talk page. Your username provides a link to your user page.

• The external link function is mainly used for these. Open an old revision or diff, and copy the URL from the address bar, pasting it where you want it.

• You can also use an internal diff link. Unlike the template {{diff}}, this kind of link can even be used in edit summaries.

• If the diff intended to be shown is between an immediately previous revision, the first parameter can be dropped.

• For an old revision, you can also use a permalink. Though here only the main text is guaranteed to be retained (images and templates will be shown as they are today, not as they were at the time).

• The following markup can be used. For example, for the article Beetroot:

• Link to a user's contributions page.

• Using the {{Color}} and {{Font color}} templates:

The {{xt}} family of templates can be used to highlight example text. These templates do not work in mainspace—that is, in regular articles—they are intended for use on project pages (such as Wikipedia:Manual of Style), help pages, and user pages.

What you type	What you get
This is {{xt|a correct example}} for comparison {{tick}}	This is a correct example for comparison Y
This is {{!xt|an incorrect example}} for contrast {{cross}}	This is an incorrect example for contrast N
This is {{mxt|in monospace}} for comparison	This is in monospace for comparison
This is {{!mxt|in monospace}} for contrast	This is in monospace for contrast
This is {{bxt|in bold}} for comparison	This is in bold for comparison
This is {{!bxt|in bold}} for contrast	This is in bold for contrast

• When editing regular Wikipedia articles, just make your changes, and do not mark them up in any special way, except when the article itself discusses deleted or inserted content, such as an amendment to a statute:
  • to indicate deleted content, use <del>...</del>
  • to indicate inserted content, use <ins>...</ins>
• This also applies to changing one's own talk page comments.

The {{Strikethrough}} template marks up a span of text with the <s>...</s> tag. This is usually renderend visually by drawing a horizontal line through it. Outside of articles, it can be used to mark something as no longer accurate or relevant without removing it from view. Do not use it, however, to indicate document edits. For that, use the <del>...</del> tag instead. See § Show deleted or inserted text for details.

A few different kinds of formatting will tell the wiki to display things as you typed them – what you see is what you get!

'''<nowiki> tag:'''

<nowiki>
The <nowiki> tag ignores [[wiki]]
''markup''. It reformats text by
removing newlines and    multiple
spaces.       It still interprets
characters specified by
&amp;name;: &rarr;
</nowiki>

'''<pre> tag:'''

<pre>The &lt;pre&gt; tag ignores [[wiki]]
''markup'' as does the &lt;nowiki&gt;
tag. Additionally, &lt;pre&gt; displays
in a mono-spaced font, and does
not  reformat    text    spaces.
It still interprets special
characters: &rarr;</pre>

The <pre> tag ignores [[wiki]]
''markup'' as does the <nowiki>
tag. Additionally, <pre> displays
in a mono-spaced font, and does
not  reformat    text    spaces.
It still interprets special
characters: →

'''[Text without a URL]:'''

Single square brackets holding
[text without a HTTP URL] are
preserved, but single square
brackets containing a URL are
treated as being an external
[https://example.com/ Web link].

'''Leading space:'''

Leading spaces are another way
to preserve formatting.
 Putting a space at the
 beginning of each line
 stops the text   from
 being reformatted.
 It still interprets [[wiki]]
 ''markup'' and special characters: &

Putting a space at the
beginning of each line
stops the text   from
being reformatted.
It still interprets wiki
markup and special characters: →

<nowiki>...</nowiki> (wiki markup contained between these two tags is displayed as normal text)

<nowiki /> (wiki markup that is interrupted by this tag is displayed as normal text, as detailed in examples below)

These two kinds of nowiki operate in different ways, but both neutralize the rendering of wiki markup as shown in the examples below. For example, the characters that have wiki markup meaning at the beginning of a line (*, #, ; and :) can be rendered in normal text. Editors can normalize the font of characters trailing a wikilink, which would otherwise appear in the wikilink font. And newlines added to wikitext for readability can be ignored.

Note to template editors: tag <nowiki> works only on its source page, not the target.

# Ordered list

<nowiki /># Ordered list

A [[micro-]]second.

A [[micro-]]<nowiki />second.

a<nowiki>

</nowiki>b

'<nowiki />'Italics' markup'<nowiki />'

<nowiki>[[Example]]</nowiki>

<nowiki><!-- revealed --></nowiki>

The rest of the section consists of simple, live examples showing how a single nowiki tag escapes entire linkage structures, beyond [[wikilink]] and {{template}}:

[[ fullpagename | label ]]

{{ pagename | parameter }}

[[fullpagename | {{ pagename }} ]]

{{ pagename | [[ fullpagename ]] }}

{{ pagename | {{ pagename }} }}

Unless you use the two "balanced" nowiki tags, troubleshooting strip marker errors and template parameter-handling inconsistencies is a risk. Also, a rendering error may arise when two [[...]] square brackets are on the same line, or two {{...}} curly brackets are in the same section, but only when the two have the nowiki markup placed inconsistently.

(These are all live examples.)

[[ wp:pagename | page name ]]
[<nowiki />[ wp:pagename | page name ]]
[[<nowiki /> wp:pagename | page name ]]
[[ wp:pagename <nowiki />| page name ]]
[[ wp:pagename | page name ]<nowiki />]

For nested structures, escaping an inner structure escapes its outer structure too.

[[ wp: {{ 1x | pagename }} ]]
[[ wp: {<nowiki />{ 1x | pagename }} ]]
[[ wp: {{<nowiki /> 1x | pagename }} ]]
[[ wp: {{ 1x <nowiki />| pagename }} ]]

For two, first pipes, two nowiki tags are required:

[[ wp: pagename | {{ 1x | label }} ]]
[[ wp: pagename <nowiki />| {{ 1x <nowiki />| label }} ]]
&lt;nowiki>[[ wp: pagename | {{ 1x | label }} ]] &lt;/nowiki>

For templates, put nowiki before the first pipe. If a parameter has a wikilink, put it in that, an inmost position.

{<nowiki />{ val | u=&gt; [[ms]] | 49082 }}
{{<nowiki /> val | u=&gt; [[ms]] | 49082 }}
{{ val <nowiki />| u=&gt; [[ms]] | 49082 }}
{{ val | u= &gt; [[ms]] | 49082 }<nowiki />}
{{ val | u= &gt; [[ ms ]<nowiki />] | 49082 }}

For input parameters, {{{1}}}, {{{2}}}, just write them out, unless they have a default (which goes behind their pipe): {{<nowiki />{1|default}}} → {{{1|default}}}

For a parser function nowiki goes between bracketing-pair characters, or anywhere before the : colon.

{{ #ifeq: inYes | inYes | outYes | outNo }}
{<nowiki />{ #ifeq: inYes | inYes | outYes | outNo }}
{{<nowiki /> #ifeq: inYes | inYes | outYes | outNo }}
{{ #ifeq<nowiki />: inYes | inYes | outYes | outNo }}
{{ #ifeq: inYes | inYes | outYes | outNo }<nowiki />}

Behavioral switches expect the tag anywhere:

 1. __HIDDENCAT__
 2. __HIDDENCAT<nowiki />__

Tags do not display; they are just markup. If you want them to, insert <nowiki /> after an < opening angle bracket; it goes only in the very front. Opening tags and closing tags must be treated separately.

<span style=color:blue> Blue </span>
<<nowiki />span style=color:blue> Blue <<nowiki />/span>
<section end=la<nowiki />bel /> 
<<nowiki />section end=label />

Use template {{tag}} instead of nowiki tags to display parser tags:

Character entities, nowiki cannot escape. To escape HTML or special character entities, replace & with &. For example, < → <

To display a nowiki tag, you can (1) use {{tag}}, (2) replace the < left angle bracket with its HTML character entity, or (3) nest nowiki tags in each other:

{{ tag | nowiki }}
<code>&amp;lt; nowiki>...&amp;lt;/ nowiki ></code>
<code><<nowiki />nowiki>...<<nowiki />/ nowiki ></code>

{{ tag | nowiki | s }}
<code>&amp;lt; nowiki /></code>
<code>&lt;&lt;nowiki /> nowiki /></code>
<code>&lt;nowiki>&lt; nowiki />&lt;/nowiki></code>

Nowiki tags do not otherwise nest, so it is the second and fourth that displays:

1&lt;nowiki>2&lt;nowiki>3</nowiki>4</nowiki>
&lt;nowiki>{{!}}&lt;nowiki></nowiki>{{!}}</nowiki>

These simply scan from left to right. The paired tags cannot overlap, because the very first pair-match nullifies any intervening tags inside. Unbalanced tags always display.

Nowiki tags do not display table markup, use <pre>...</pre>.

<pre> is a parser tag that emulates the HTML <pre> tag. It defines preformatted text that is displayed in a fixed-width font and is enclosed in a dashed box. HTML-like and wiki markup tags are escaped, spaces and line breaks are preserved, but HTML elements are parsed.

<pre><!--Comment-->

[[wiki]] markup &amp;</pre>

<!--Comment-->

[[wiki]] markup &amp;

As <pre> is a parser tag, it escapes wikitext and HTML tags. This can be prevented with the use of <includeonly></includeonly> within the <pre>, making it act more like its HTML equivalent:

<pre<includeonly></includeonly>><!--Comment-->

[[wiki]] markup &amp;</pre>

wiki markup &

Invisible HTML <pre> tags can also be inserted by preceding text with a space character, like:

wiki markup &

Alternatively, consider using {{pre}} template or <syntaxhighlight lang="text">...</syntaxhighlight>.

It's uncommon – but on occasion acceptable for notes to other editors – to add a hidden comment within the text of an article. These comments are visible only when editing or viewing the source of a page. Most comments should go on the appropriate Talk page. The format is to surround the hidden text with "<!--" and "-->" and may cover several lines, e.g.:

<!-- An example of hidden comments
 This won't be visible except in "edit" mode. -->

Another way to include a comment in the wiki markup uses the {{Void}} template, which can be abbreviated as {{^}}. This template "expands" to the empty string, generating no HTML output; it is visible only to people editing the wiki source. Thus {{^|A lengthy comment here}} operates similarly to the comment <!-- A lengthy comment here -->. The main difference is that the template version can be nested, while attempting to nest HTML comments produces odd results.

{{NUMBEROFARTICLES}} is the number of pages in the main namespace that contain a link and are not a redirect. This includes full articles, stubs containing a link, and disambiguation pages.

{{CURRENTMONTHNAMEGEN}} is the genitive (possessive) grammatical form of the month name, as used in some languages but not in English; {{CURRENTMONTHNAME}} is the nominative (subject) form, as usually seen in English.

In languages where it makes a difference, you can use constructs like {{grammar:case|word}} to convert a word from the nominative case to some other case. For example, {{grammar:genitive|{{CURRENTMONTHNAME}}}} means the same as {{CURRENTMONTHNAMEGEN}}.

Many HTML tags can be used in wiki markup. You can check your HTML by using markup validation.

[[File: | thumb | upright | right | alt= | caption ]]

<ref>{{cite web
 |url= 
 |title= 
 |author= 
 |date= 
 |website= 
 |publisher= 
 |access-date= 
}}</ref>

<ref>{{cite journal
 |last1= 
 |first1= 
 |last2= 
 |first2= 
 |date= 
 |title= 
 |journal= 
 |volume= 
 |issue= 
 |pages= 
 |publisher= 
 |doi= 
 |url= 
 |access-date= 
}}</ref>

<ref>{{cite book
 |last= 
 |first= 
 |author-link= 
 |title= 
 |publisher= 
 |series= 
 |date=  
 |doi= 
 |isbn= 
}}</ref>

<ref>{{cite book
 |last1        = 
 |first1       = 
 |last2        = 
 |first2       = 
 |author-link1 = 
 |author-link2 = 
 |editor       = 
 |title        = 
 |trans-title  = 
 |url          = 
 |access-date  = 
 |edition      = 
 |series       = 
 |volume       = 
 |date         = 
 |publisher    = 
 |location     = 
 |isbn         = 
 |doi          = 
 |page         = 
 |pages        = 
 |chapter      = 
}}</ref>

{{convert|original_value|original_unit|conversion_unit|abbr=on}}

{{convert|orig_val1|range|orig_val2|original_unit|conversion_unit|abbr=on}}

{{convert|60|and|170|kg|lb|abbr=on}}
{{convert|18|°C|°F}}
{{convert|3.21|kg|lb}}

<ref name="NAMEOFREF" />

{{blockquote |text= |sign= }}

<blockquote>
<p>QUOTED PARAGRAPH</p>
<p>NAME, SOURCE, REFERENCE</p>
</blockquote>

{{About|USE1}}

{{About|USE1||PAGE2}}

{{About|USE1|USE2|PAGE2}}

{{About|USE1|USE2|PAGE2|USE3|PAGE3|USE4|PAGE4|USE5|PAGE5}}

{|
|-
! scope="col" |COLUMN1
! scope="col" |COLUMN2
|-
|ROW1
|ROW1/COL2
|-
|ROW2
|ROW2/COL2
|}

{| class="wikitable"
|-
! scope="col" |COLUMN1
! scope="col" |COLUMN2
|-
|ROW1
|ROW1/COL2
|-
|ROW2
|ROW2/COL2
|}

{| class="wikitable mw-collapsible mw-collapsed" style="text-align: left;margin:0px;"
|- 
! style="width:20em;" |COLUMN1
! style="width:20em;" |COLUMN2
|- 
|ROW1
|ROW1/COL2
|-
|ROW2
|ROW2/COL2
|-
|}

{{col-begin|width=100%}}
{{col-break|width=}} 
{{col-end}}

 * {{subst:uw-vandalism1|PageName}} ~~~~ (unintentional vandalism/test)
 * {{subst:uw-delete1|PageName}} ~~~~ (unintentional removal of content)
 * {{subst:uw-vandalism2|PageName}} ~~~~ (suitable for intentional nonsense or disruption)
 * {{subst:uw-delete2|PageName}} ~~~~ (variant for removal of content)
 * {{subst:uw-vandalism3|PageName}} ~~~~ ("please stop" for use after level 2 warning)
 * {{subst:uw-delete3|PageName}} ~~~~ (please stop removing content)
 * {{subst:uw-vandalism4|PageName}} ~~~~ (last warning for vandalism)
 * {{subst:uw-delete4|PageName}} ~~~~ (last warning for removing content)
 * {{subst:uw-vandalism4im|PageName}} ~~~~ (only warning; for severe or grotesque vandalism only)
 * {{subst:uw-delete4im|PageName}} ~~~~ (only warning; for many blankings in a short period of time)

{{rp|page=}}

Help desk

See the 'Coding wiki markup' section of the Help navigation navbox below for additional links.

• Wikipedia:User page design guide/Style
• Wikipedia:Extended image syntax: advanced visual file markup.
• Help:A quick guide to templates: an introduction to templates.
• Help:Substitution: substitution is an alternative way of including templates than transclusion.
• Help:Score: how to render musical scores.
• Help:Displaying a formula: displaying mathematical formulae.
• Editing Wikitext at Wikibooks.
• Parsoid: MediaWiki application that allows for converting back and forth between wikitext and HTML.
• {{Syntaxhighlight}}: template to show wrapped syntax-highlighted text.