Help:Wikitext: Difference between revisions

Revision as of 02:04, 8 November 2023

Revision as of 19:17, 16 August 2025

(48 intermediate revisions by 25 users not shown)

Line 6:

{{Locutions pages header}}

{{Wikipedia how to|H:WT|H:MARKUP|H:WIKICODE}}

{{VE documentation}}

{{Wikitext navbox}}

The markup language called '''wikitextWikitext''', also known as '''wiki markup''' or '''wikicode''', consists ofis the syntax[[markup and keywordslanguage]] used by the [[MediaWiki]] software to format a pagepages. (Note the use of lowercase spelling offor these terms.){{efn|Wikipedia is an encyclopedia that uses wikitext—wikitext is not named after Wikipedia.}} 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]].

To learn how to view and edit wikitext, and how to save changes, see [[Help:Editing]]. In most cases, markup can be copied and pasted without the need to write new code. A quick reference guide is available at [[Help:Cheatsheet]].

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

In addition to wikitext, some [[HTML elementelements]]s are also allowedpermitted for presentation formatting. SeeFor more details, see [[Help:HTML in wikitext]] for information on this.

{{TOC limit}}

Line 42 ⟶ 45:

}}

The four hyphens must appear at the beginning of a line.

HTML equivalent: {{tag|hr|s}} (which can be indented, whereas <nowiki>----</nowiki> always starts at the left margin.)

The HTML equivalent: is {{tag|hr|s}}, (which can be indented, whereasif required. (<nowikicode>----</nowikicode> always starts at the left margin.)

The template {{tl|Hr}} produces a similar rule but allows the thickness to be specified.

====Table of contents====

Line 60 ⟶ 67:

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 {{key press|Enter}} twice.

** It's good practice to do this by itself when publishing changes. Leave additional changes to another edit because otherwise only the line break will be highlighted [https://en.wikipedia.org/w/index.php?title=Silvia_Vald%C3%A9s&diff=prev&oldid=1134979713 in the diff].

* Pressing {{key press|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.

{{markup

Line 225 ⟶ 230:

}}

====<span class="anchor" id="DL"></span><span class="anchor" id="Definition lists"></span><span class="anchor" id="Association lists"></span><span class="anchor" id="H:DL"></span>Description lists====

===={{Anchor|DL}}Description lists====

{{anchors|Definition lists|Association lists|H:DL}}

{{Shortcut|H:DL}}

Line 368 ⟶ 372:

[[mw:Extension:SyntaxHighlight|Syntax highlighting]] for source code.

Computer code has colored text and more stringent formatting. For example, to define a function: <code>int m2()</code>, with highlights, in C++.

See [https://github.com/wikimedia/mediawiki-extensions-SyntaxHighlight_GeSHi/blob/master/SyntaxHighlight.lexers.php here] for a full list of supported languages that can be put in <code>lang="????"</code>

Line 426 ⟶ 430:

To prevent two words from becoming separated by a [[linewrap]] (e.g. ''Mr.&nbsp;Smith'' or ''400&nbsp;km/h'') a '''[[non-breaking space]]''', sometimes also called a "non-printing character", may be used between them. (For three or more words, the template {{tl|nowrap}} is probably more suitable.)

|

<syntaxhighlight lang="html">Mr.&amp;nbsp;Smith or 400&amp;nbsp;km/h</syntaxhighlight>

|

Mr.&nbsp;Smith or 400&nbsp;km/h

Line 597 ⟶ 601:

|<hiero>P2</hiero>

}}

====Chess symbols====

{{main|Chess symbols in Unicode}}

For example, &amp;#9812; displays &#9812;

====Subscripts and superscripts====

Line 771 ⟶ 770:

{{main|Help:Link}}

===Wikilinks<span class="anchor" id="Free links"></span>===

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

Line 901 ⟶ 900:

|}

====Create a pagenew link=page===

* To create a new page:

*# SaveEdit thatany page.

*# Create a link to it on some other (related) page.

*# Enter a [[help:Redlink|redlink]] wikilink: <nowiki>[</nowiki>[page name]].

*# Save that page.

*# Preview or save.

*# Click onActivate the link you just made. The new page will open for editing.

* For more information, see [[Wikipedia:Starting an article|starting an article]] and check out Wikipedia's [[Wikipedia:Naming conventions|naming conventions]].

* Please dolink notto create ayour new article without linking to it from at least one other article.

{| class="wikitable"

Line 923:

|}

===Create an alias for a page===

===Redirects===

{{main|Help:Redirect}}

* Create an alias for any page by creating a [[Wikipedia:Redirect|Redirect]] from one [[Help:Page name| page name]] to another.

* [[Wikipedia:Redirect|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]]").

* First create a new page whose page name is the name of the alias. That is the redirect.

* 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.

* On the ''first'' line of the new redirect page, use the syntax shown in the table below. For example, [[US]] is a redirect.

* 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.

{| class="wikitable" border=1

Line 1,119 ⟶ 1,121:

''Unnamed link''

This should [[WP:CS:EMBED|not be used in articles]] except in [[Wikipedia:External links#Links in lists|certain lists]].

''(Used only within article body for footnotes)''

|

<syntaxhighlight lang="wikitext" inline>[https://www.wikipedia.org]</syntaxhighlight>

Line 1,244 ⟶ 1,246:

* Embedding the image in the text is only possible for very small images.

* Embedding the image will affect the vertical formatting of text.

|- style="vertical-align: top;" id="alt tag"

| <syntaxhighlight lang="wikitext">With alternative text:

[[File:wiki.png|alt=Puzzle globe logo]]</syntaxhighlight>

Line 1,252 ⟶ 1,254:

|

* {{anchor|alt tag}}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 [[Wikipedia:Alternative text for images|Alternative text for images]] for help on choosing it.

|- style="vertical-align:top;"

Line 1,274 ⟶ 1,276:

* 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|px tag]]

* The attributes left, center or centre override this, and places the image to the left or the centre of the page. {{anchor|upright tag}}

* The last parameter is the caption that appears below the image.

Line 1,301 ⟶ 1,303:

* The [[WP:PIC|picture tutorial]] explains more options.

|- style="vertical-align:top;" id="px tag"

| <syntaxhighlight lang="wikitext">A picture resized to 50 pixels...

[[File:wiki.png|50 px|Wikipedia encyclopedia]]</syntaxhighlight>

Line 1,309 ⟶ 1,311:

|

* {{anchor|px tag}}The [[WP:PIC|picture tutorial]] explains more options.

* Sizing in pixels is deprecated and should be used very sparingly.

* There is an [[#upright tagWP:PICSIZE|''upright'' attributeparameter]] that should be used instead. These tags are optimised for both laptop and mobile phone screens.

|- style="vertical-align:top;"

Line 1,325 ⟶ 1,327:

|- style="vertical-align:top;"

| <syntaxhighlight lang="wikitext">Linking directly to an image without displaying it:

<nowiki>[[Media:wiki.png|Image of jigsaw globe]]</syntaxhighlight>

| Linking directly to an image without displaying it:

Line 1,457 ⟶ 1,459:

If a page is transcluded without transclusion markup, it may cause an unintentional [[Help:Category#Putting_pages_in_categories|categorization]]. Any page transcluding it will contain the same category as the original page. Wrap the category markup with '''<nowiki><noinclude></nowiki>''' tags to prevent incorrect categorization.

{{anchor|hovertext}}

Some templates take ''parameters'', as well, which you separate with the pipe character <code>|</code>.

Line 1,473 ⟶ 1,475:

|

{{Help:Transclusion demo}}

|- id=hovertext

|-

|

<syntaxhighlight lang="wikitext">

Line 1,627 ⟶ 1,629:

===Coloring and highlighting text===

<!-- requiring edit, color properties not appearing correctly and the text is still white -->

*Using the {{tl|Color}} and {{tl|Font color}} templates:

{| class="wikitable"

Line 1,650 ⟶ 1,652:

This is how to {{Font color||yellow|highlight part of a sentence}}.

|}

===Example text===

Line 1,678:

|}

===<span class="anchor" id="Strikethrough"></span>Show deleted or inserted text===

{{details|Wikipedia:Talk page guidelines#Editing own comments}}

* 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 {{tag|del}} (The {{tl|strikethrough}} template can also be used for this purpose.)

** to indicate inserted content, use {{tag|ins}}

* This also applies to changing one's own talk page comments.

Line 1,690:

|-

|

<syntaxhighlight lang="wikitext" inline>You can indicate <del>indicate deleted material</del> and <ins>inserted material</ins> material.</syntaxhighlight>

|

You can indicate <del>indicate deleted material</del> and <ins>inserted material</ins> material.

|}

===<span class="anchor" id="Strikethrough"></span> Strikethrough ===

=={{anchor|Limiting formatting}} Limiting formatting / escaping wiki markup==

{{see also|Help:HTML in wikitext#s}}

The {{tl|Strikethrough}} template marks up an inline span of text with the {{tag|s}} tag. This is usually rendered 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 {{tag|del}} tag instead. See {{slink||Show deleted or inserted text}} for details.

The {{tl|Strikethrough}} template and {{tag|s}} tag are for inline content only; to strike out a block of text, such as a multi-line talk page post, use either {{tl|Strikethroughdiv}} or <syntaxhighlight lang=wikitext inline><div style="text-decoration: line-through"></div></syntaxhighlight> to render the entire block with strikethrough markup.

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

{| class=wikitable

!What you type

!What you get

|-

|<kbd><nowiki>This is {{</nowiki>'''Strikethrough'''<nowiki>|an obsolete stretch of text}} for comparison</nowiki></kbd>

|This is {{Strikethrough|an obsolete stretch of text}} for comparison

|-

|<kbd><nowiki>This is {{</nowiki>'''Strikethroughdiv'''<nowiki>|{{ubl|an obsolete bulleted list|with two items}}}} for comparison</nowiki></kbd>

|This is {{Strikethroughdiv|{{ubl|an obsolete bulleted list|with two items}}}} for comparison

|}

=={{<span class="anchor|" id="Limiting formatting}}"></span><span class="anchor" id="Limiting formatting / escaping wiki markup"></span> Limiting formatting and escaping wikitext ==

{{see also|Template:Escape template list}}

Several formatting methods in wikitext can force the wikitext to be displayed exactly as typed – essentially a "[[WYSIWYG|what you see is what you get]]" effect. These techniques are useful when you need to prevent wikitext from being interpreted by [[parser]], such as when showing examples of wikitext nested in a template.

{| class="wikitable" style="margin-right:0em;"

Line 1,795 ⟶ 1,812:

|}

===<span class="anchor" id="NOWIKI"></span>Nowiki===

{{redirect|WP:NOWIKI|the essay about the name "Wiki"|Wikipedia:Don't abbreviate "Wikipedia" as "Wiki"!|the Wikipedia language edition|Norwegian Wikipedia}}

{{anchor|NOWIKI}}

{{redirect|WP:NOWIKI|the essay about the name "Wiki"|Wikipedia:Don't abbreviate "Wikipedia" as "Wiki"!}}

{{shortcut|H:NOWIKI|WP:NOWIKI}}

There are two types of nowiki markup, which operate in different ways:

:{{tag|nowiki}} (wiki markup contained between these two tags is displayed as normal text)

:{{tag|nowiki|s}} (wiki markup that is interrupted by this tag is displayed as normal text, as detailed in examples below)

:* The {{tag|nowiki}} (wikitag markuppair containedencloses betweena thesesection twoof tagswiki markup, which is then displayed as normal text).

* The empty {{tag|nowiki|s}} tag ''interrupts'' the wiki markup and causes it to display as normal text.

TheseBoth two kinds of nowiki operate in different ways, but bothforms 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 ({{code|*}}, {{code|#}}, {{code|;}} and {{code|:}}) 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 {{tag|nowiki|o}} works only on its source page, not the target.

Line 1,834 ⟶ 1,852:

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

:[[ ''[[wp:fullpagename|''fullpagename]]'']] <nowiki />| ''label'' ]]

:{{ ''pagename'' <nowiki />| ''parameter'' }}

:[[ ''fullpagename'' | {{ ''pagename'' }<nowiki />} ]<nowiki />]

Line 1,896 ⟶ 1,914:

{{markup|

<syntaxhighlight lang="wikitext">

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

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

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

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

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

Line 1,907 ⟶ 1,925:

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

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

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

</poem>

}}

====Displaying magic words====

{{Further|Help:Magic words|Help:Parser function}}

Line 2,033 ⟶ 2,052:

}}

{{anchor|Invisible pre}}Invisible HTML {{tag|pre|o}} tags can also be inserted by preceding text with a space character, like:

<!--Comment-->

Line 2,060 ⟶ 2,079:

|-

| <nowiki>{{CURRENTWEEK}}</nowiki> || {{CURRENTWEEK}}

|Number of weeks since January 1 (January 1 can be in week 1; but only if it's a Monday, Tues, Wed, Thurs - if it's Friday, Sat or Sun, Jan 1 will be in week 52 or 53){{cn|date=August 2025|}}

|

|-

| <nowiki>{{CURRENTDOW}}</nowiki> || {{CURRENTDOW}}

|

Monday0 =Sunday, 1 = Monday, Tuesday2 = 2Tuesday, etc.,.. but Sunday6 = 0Saturday

|-

Line 2,072 ⟶ 2,091:

| <nowiki>{{CURRENTMONTHNAME}}</nowiki>

| {{CURRENTMONTHNAME}}

|The nominative (subject) form, as usually seen in English

|

|-

| <nowiki>{{CURRENTMONTHNAMEGEN}}</nowiki>

| {{CURRENTMONTHNAMEGEN}}

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

|

|-

| <nowiki>{{CURRENTDAY}}</nowiki> || {{CURRENTDAY}}

Line 2,092 ⟶ 2,111:

| <nowiki>{{NUMBEROFARTICLES}}</nowiki>

| {{NUMBEROFARTICLES}}

'''{{tlf|NUMBEROFARTICLES}}''' is the numberNumber 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.

|

|-

| <nowiki>{{NUMBEROFPAGES}}</nowiki>

Line 2,141 ⟶ 2,160:

|

|}

In languages where it makes a difference, you can use constructs like <syntaxhighlight lang="wikitext" inline>{{grammar:case|word}}</syntaxhighlight> to convert a word from the nominative case to some other case. For example, <syntaxhighlight lang="wikitext" inline>{{grammar:genitive|{{CURRENTMONTHNAME}}}}</syntaxhighlight> means the same as <syntaxhighlight lang="wikitext" inline>{{CURRENTMONTHNAMEGEN}}</syntaxhighlight>. <!-- Is there a reference for this, other than the source code (for example, phase3/languages/Lnaguage*.php) ? -->

'''{{tlf|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.

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

In languages where it makes a difference, you can use constructs like <syntaxhighlight lang="wikitext" inline>{{grammar:case|word}}</syntaxhighlight> to convert a word from the nominative case to some other case. For example, <syntaxhighlight lang="wikitext" inline>{{grammar:genitive|{{CURRENTMONTHNAME}}}}</syntaxhighlight> means the same as <syntaxhighlight lang="wikitext" inline>{{CURRENTMONTHNAMEGEN}}</syntaxhighlight>. <!-- Is there a reference for this, other than the source code (for example, phase3/languages/Lnaguage*.php) ? -->

==HTML==

Line 2,171 ⟶ 2,185:

*[[mw:Parsoid|Parsoid]]: MediaWiki application that allows for converting back and forth between wikitext and HTML.

*{{tl|Syntaxhighlight}}: template to show wrapped syntax-highlighted text.

*[[Help:Displaying a formula]]: [[Help:Displaying a formula#LaTeX basics|LaTeX]] and [[Help:Displaying a formula#Chemistry|Chemistry notation]]

{{Wikipedia directories}}