Help:Formatting: Difference between revisions

From MediaWiki-1.39
Jump to navigation Jump to search
(Formatting)
 
No edit summary
Line 1: Line 1:
<languages/>
{{PD Help Page}}
{{see also|Help:Advanced editing}}
<translate>
<translate>
<!--T:1-->
<!--T:1-->

Revision as of 12:31, 15 January 2026

<languages/> Template:PD Help Page Template:See also <translate> You can format your text by using wiki markup. This consists of normal characters like asterisks, apostrophes, or equal signs which have a special function in the wiki, sometimes depending on their position. For example, to format a word in italic, you include it in two pairs of apostrophes like ''this''.

Text formatting markup

</translate>

<translate> Description</translate> <translate> You type</translate> <translate> You get</translate>
Template:Anchor<translate> Character (inline) formatting – applies anywhere</translate>
<translate> Italic text</translate>
''<translate nowrap><!--T:8--> italic</translate>''

<translate> italic</translate>

<translate> Bold text</translate>
'''<translate nowrap><!--T:11--> bold</translate>'''

<translate> bold</translate>

<translate> Bold and italic</translate>
'''''<translate nowrap><!--T:14--> bold & italic</translate>'''''

<translate> bold & italic</translate> Template:Table-AnchorRow

<translate> Escape wiki markup</translate> <syntaxhighlight lang="html">

Template:^(nowikiTemplate:)^<translate nowrap> no wiki markup</translate>Template:^(/nowikiTemplate:)^ </syntaxhighlight>

<translate> no [[wiki]] ''markup''</translate>

Template:Anchor<translate> Section formatting – only at the beginning of the line</translate>
<translate> Section Headings of different levels</translate> Template:Anchor
<translate nowrap>
== Level 2 == <!--T:26-->

=== Level 3 === <!--T:27-->

==== Level 4 ==== <!--T:28-->

===== Level 5 ===== <!--T:29-->

====== Level 6 ====== <!--T:30-->
</translate>

Note:

  • <translate> [[<tvar name=lv1>Help talk:Formatting#Level_1</tvar>|Skip Level 1]], it is page name level.</translate>
  • <translate> Do not put any text on the same line after the ending equal signs.</translate>
  • <translate> An article with 4 or more headings automatically creates a table of contents (unless setting the magic word <tvar name=1>__NOTOC__</tvar>).</translate>

<translate>

Level 2

Level 3

Level 4

Level 5
Level 6

</translate>

<translate> Horizontal rule</translate>
<translate nowrap><!--T:41--> Text before</translate>
----
<translate nowrap><!--T:42--> Text after</translate>

<translate> Text before</translate>


<translate> Text after</translate>

<translate> Bullet list</translate> Template:Anchor
<translate nowrap>
<!--T:46-->
* Start each line
* with an [[Wikipedia:asterisk|asterisk]] (*).
** More asterisks give deeper
*** and deeper levels.
* Line breaks <br>don't break levels.
*** But jumping levels creates empty space.
Any other start ends the list.

<!--T:160-->
* combine bullet list
** with definition 
::- definition
** creates empty space

<!--T:161-->
* combine bullet list
** with definition 
*:- definition
** without empty spaces

<!--T:162-->
*bullet list
:- definition
:* sublist that doesn't create empty
:* spaces after definition
</translate>

<translate>

  • Start each line
  • with an asterisk (*).
    • More asterisks give deeper
      • and deeper levels.
  • Line breaks
    don't break levels.
      • But jumping levels creates empty space.

Any other start ends the list.

  • combine bullet list
    • with definition
- definition
    • creates empty space
  • combine bullet list
    • with definition
    - definition
    • without empty spaces
  • bullet list
- definition
  • sublist that doesn't create empty
  • spaces after definition

</translate>

<translate> Numbered list</translate> Template:Anchor
<translate nowrap>
<!--T:49-->
# Start each line
# with a [[Wikipedia:Number_sign|number sign]] (#).
## More number signs give deeper
### and deeper
### levels.
# Line breaks <br>don't break levels.
### But jumping levels creates empty space.
# Blank lines

<!--T:50-->
# end the list and start another.
Any other start also
ends the list.

<!--T:183-->
<tvar name=1><nowiki>#</nowiki></tvar> use "nowiki" tags to display a literal (#) at the beginning of a line without interpreting it as a numbered list.
</translate>

<translate>

  1. Start each line
  2. with a number sign (#).
    1. More number signs give deeper
      1. and deeper
      2. levels.
  3. Line breaks
    don't break levels.
      1. But jumping levels creates empty space.
  4. Blank lines
  1. end the list and start another.

Any other start also ends the list.

<tvar name=1>#</tvar> use "nowiki" tags to display a literal (#) at the beginning of a line without interpreting it as a numbered list.</translate> Template:Table-AnchorRow

<translate> Description list</translate>
<translate nowrap>
<!--T:54-->
;item 1
: definition 1
;item 2
: definition 2-1
: definition 2-2
</translate>

Note: <translate> At the end of the line, if the line begins with a semicolon (;), any inserted colon (:) will not be displayed.</translate> <translate> If you want for the colon to be displayed, escape it by writing <tvar name=1>&#58;</tvar>.</translate>

<translate>

item 1
definition 1
item 2
definition 2-1
definition 2-2

</translate>

<translate> Description details without description terms</translate>
: <translate nowrap><!--T:195--> Description details</translate>
:: <translate nowrap><!--T:196--> Nested description details</translate>
::::: <translate nowrap><!--T:197--> Deeply nested description details</translate>

Note: <translate> This is often used as a workaround for indenting the line, but it will harm accessibility and produce invalid HTML output.</translate> <translate> Using CSS for visual indentation is a far more preferable approach (e.g. <tvar name=1>Template:Tl</tvar>).</translate>

<translate> Description details</translate>
<translate> Nested description details</translate>
<translate> Deeply nested description details</translate>
<translate> Mixture of different types of list</translate> <syntaxhighlight lang="html">

<translate nowrap>

  1. one
  2. two
    • two point one
    • two point two
  3. three
    three item one
    three def one
  4. four
    four def one
    this looks like a continuation
    and is often used
    instead <tvar name=1>
    </tvar> of <tvar name=2><br></tvar>
  5. five
    1. five sub 1
      1. five sub 1 sub 1
    2. five sub 2

</translate> </syntaxhighlight>


Note: <translate> The usage of <tvar name=1>#:</tvar> and <tvar name=2>*:</tvar> for breaking a line is as problematic as the usage of single <tvar name=3>:</tvar>.</translate>

<translate>

  1. one
  2. two
    • two point one
    • two point two
  3. three
    three item one
    three def one
  4. four
    four def one
    this looks like a continuation
    and is often used
    instead <tvar name=1>
    </tvar> of <tvar name=2><br></tvar>
  5. five
    1. five sub 1
      1. five sub 1 sub 1
    2. five sub 2

</translate>

Template:Anchor<translate> Preformatted text</translate>
 <translate nowrap><!--T:65--> Start each line with a space.</translate>
 <translate nowrap><!--T:179--> Text is '''preformatted''' and</translate>
 <translate nowrap><!--T:180--> ''markups'' '''''can''''' be done.</translate>

Note: <translate> This way of preformatting only applies to [[<tvar name=1>#Section formatting</tvar>|section formatting]].</translate> <translate> [[<tvar name=1>#Character formatting</tvar>|Character formatting]] markups are still effective.</translate>

<translate> Start each line with a space.</translate>
<translate> Text is preformatted and</translate>
<translate> markups can be done.</translate>
<translate> Preformatted text blocks</translate>
 <nowiki><translate nowrap><!--T:69-->
Start with a space in the first column,
(before the <tvar name=1><nowiki></tvar>).

<!--T:70-->
Then your block format will be
    maintained.

<!--T:170-->
This is good for copying in code blocks:
</translate>

def function():
    """<translate nowrap><!--T:171--> documentation string</translate>"""

    if True:
        print True
    else:
        print False</nowiki>
<translate nowrap>
Start with a space in the first column,
(before the <nowiki>).

Then your block format will be
    maintained.

This is good for copying in code blocks:
</translate>

def function():
    """<translate nowrap> documentation string</translate>"""

    if True:
        print True
    else:
        print False

Template:Anchor <translate>

Paragraphs

</translate> Template:Anchor <translate> MediaWiki ignores single line breaks. To start a new paragraph, leave an empty line. You can force a line break within a paragraph with the HTML tag <tvar name=1>Template:Tag</tvar>.

HTML tags

</translate> Template:Anchor <translate> Some HTML tags are allowed in MediaWiki, for example <tvar name=1>Template:Tag</tvar>, [[w:Div and span|<tvar name=2>Template:Tag</tvar>, and <tvar name=3>Template:Tag</tvar>]]. These apply anywhere you insert them. </translate>

<translate> Description</translate> <translate> You type</translate> <translate> You get</translate>

Template:Table-AnchorRow

<translate> Inserted
(Displays as underline in most browsers)</translate>
<syntaxhighlight lang=html>

<translate nowrap> Inserted</translate>

<translate nowrap> or</translate>

<translate nowrap> Underline</translate> </syntaxhighlight>

<translate> Inserted</translate>

<translate> or</translate>

<translate> Underline</translate> Template:Table-AnchorRow

<translate> Deleted
(Displays as strike-through in most browsers)</translate>
<syntaxhighlight lang=html>

<translate nowrap> Strike-through</translate>

<translate nowrap> or</translate>

<translate nowrap> Deleted</translate>

</syntaxhighlight>

<translate> Strike-through</translate>

<translate> or</translate>

<translate> Deleted</translate> Template:Table-AnchorRow

<translate> Fixed width text</translate> <syntaxhighlight lang=html><translate nowrap> Source code</translate></syntaxhighlight> <translate> Source code</translate>

Template:Table-AnchorRow

<translate> Blockquotes</translate> <syntaxhighlight lang=html>

<translate nowrap> Text before</translate>

<translate nowrap> Blockquote</translate>

<translate nowrap> Text after</translate> </syntaxhighlight>

Note: <translate> If the quote contains multiple paragraphs the tags need to be on separate lines to display properly, i.e.:</translate> <syntaxhighlight lang=html>

<translate nowrap> First paragraph.</translate>

<translate nowrap> Second paragraph.</translate>

</syntaxhighlight> Template:Tracked

<translate> Text before</translate>

<translate> Blockquote</translate>

<translate> Text after</translate> Template:Table-AnchorRow

<translate> Quotes</translate> <syntaxhighlight lang=html><translate nowrap> This is a quotation</translate></syntaxhighlight>

Note: <translate> The q element must not be used in place of quotation marks that do not represent quotes; for example, it is inappropriate to use the q element for marking up sarcastic statements.<ref>[<tvar name=url>https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-q-element</tvar> HTML Living Standard—The <tvar name=q><q></tvar> element]</ref></translate>

<translate> This is a quotation</translate>
<translate> Comment</translate> <syntaxhighlight lang=html>

<translate nowrap> Comments are visible only in the edit zone. </translate> </syntaxhighlight>

<translate> Comments are visible only in the edit zone. </translate> Template:Table-AnchorRow

<translate> Completely preformatted text</translate> <syntaxhighlight lang="html">
<translate nowrap>
<!--T:115-->
Text is '''preformatted''' and 
''markups'' '''''cannot''''' be done
</translate>

</syntaxhighlight>


Note: <translate> For marking up of preformatted text, check the "Preformatted text" entry at the end of the previous table.</translate>

<translate nowrap>
<!--T:117-->
Text is '''preformatted''' and 
''markups'' '''''cannot''''' be done
</translate>
<translate> Customized preformatted text</translate> <syntaxhighlight lang="html">
<translate nowrap>
<!--T:119-->
Text is '''preformatted''' 
with a style and 
''markups'' '''''cannot''''' be done
</translate>

</syntaxhighlight>


Note: <translate> A CSS style can be named within the style attribute.</translate>

<translate nowrap>
<!--T:121-->
Text is '''preformatted''' 
with a style and 
''markups'' '''''cannot''''' be done
</translate>

<translate> continued:</translate>

<translate> Description</translate> <translate> You type</translate> <translate> You get</translate>
<translate> Default preformatted text has a CSS attribute (white-space: pre-wrap;) to wrap the text according to available width</translate> <syntaxhighlight lang=html>
<translate nowrap><!--T:127--> This long sentence is used to demonstrate text wrapping. This additional sentence makes the text even longer. This additional sentence makes the text even longer.</translate>

</syntaxhighlight>

<translate nowrap><!--T:128--> This long sentence is used to demonstrate text wrapping. This additional sentence makes the text even longer. This additional sentence makes the text even longer.</translate>
<translate> Customized preformatted text with disabled text wrapping</translate> <syntaxhighlight lang=html>
<translate nowrap><!--T:130--> This long sentence is used to demonstrate text wrapping. This additional sentence makes the text even longer. This additional sentence makes the text even longer.</translate>

</syntaxhighlight>

<translate nowrap><!--T:131--> This long sentence is used to demonstrate text wrapping. This additional sentence makes the text even longer. This additional sentence makes the text even longer.</translate>

<translate> The full list of recognized tags is given on <tvar name=1>Template:Ll</tvar>.

Inserting symbols

Symbols and other special characters not available on your keyboard can be inserted in a multitude of ways. [<tvar name=url>http://www.howtogeek.com/210824/how-to-quickly-type-special-characters-on-any-computer-smartphone-or-tablet/</tvar> Many operating systems and browsers allow to insert special characters] through a menu option or operating system panel. Additionally, you can use the WikiEditor or [[<tvar name=2>Special:MyLanguage/VisualEditor/Special characters</tvar>|VisualEditor]] to insert them into the edit screen. </translate>

<translate> As a last resort, you can use a special sequence of characters.</translate> <translate> Those sequences are called [<tvar name=url>https://developer.mozilla.org/docs/Glossary/Character_reference</tvar> HTML character references].</translate> <translate> For example:</translate>

  • <translate> the rightwards arrow symbol (<tvar name=1></tvar>) can be displayed using the <tvar name=2>&rarr;</tvar> sequence</translate>
  • <translate> an em dash (<tvar name=1></tvar>) can be displayed using <tvar name=2>&mdash;</tvar>.</translate>

Note: <translate> Hover over any symbol to reveal the entity that produces it. Some symbols not available in the current font will appear as empty squares.</translate>


<translate> HTML symbol entities</translate>
Á á Â â ´ Æ æ À à Α α & Å å Ã ã Ä ä Β β ¦ Ç ç ¸ ¢
Χ χ ˆ © ¤ ° Δ δ ÷ É é Ê ê È è Ε ε Η η
Ð ð Ë ë ƒ ½ ¼ ¾ Γ γ > Í í Î î ¡ Ì ì Ι ι
¿ Ï ï Κ κ Λ λ « < ¯ µ · Μ μ  
¬ Ñ ñ Ν ν Ó ó Ô ô Œ œ Ò ò Ω ω Ο ο ª º Ø ø Õ õ Ö
ö Φ φ Π π ϖ ± £ Ψ ψ " » ® Ρ ρ
Š š § ­ Σ σ ς ¹ ² ³ ß Τ τ Θ θ ϑ Þ þ ˜
× Ú ú Û û Ù ù ¨ ϒ Υ υ Ü ü Ξ ξ Ý ý ¥ ÿ Ÿ Ζ ζ
<translate> Description</translate> <translate> You type</translate> <translate> You get</translate>
<translate> Copyright symbol</translate> &copy;
©
<translate> Greek delta letter symbol</translate> &delta;
δ
<translate> Euro currency symbol</translate> &euro;

<translate> See the list of all HTML entities on the Wikipedia article List of HTML entities. Additionally, MediaWiki supports two non-standard entity reference sequences: &רלמ; and &رلم; which are both considered equivalent to &rlm; which is a right-to-left mark. (Used when combining right to left languages with left to right languages in the same page.)

HTML tags and symbol entities displayed themselves (with and without interpreting them)

</translate>

<syntaxhighlight lang=html inline>&euro;</syntaxhighlight>  → &euro;
<syntaxhighlight lang=html inline><translate nowrap> Typo to be corrected</translate></syntaxhighlight>  → <translate> Typo to be corrected</translate>
<syntaxhighlight lang=html inline><span style="color: red; text-decoration: line-through;"><translate nowrap> Typo to be corrected</translate></syntaxhighlight>  → <span style="color: red; text-decoration: line-through;"><translate> Typo to be corrected</translate></span>

<translate>

Nowiki for HTML

</translate> Template:Tag <translate> can prohibit (HTML) tags:</translate>

  • <<nowiki/>pre>  → <pre>

<translate> But not & symbol escapes:</translate>

  • &<nowiki/>amp;  → &

<translate> To print & symbol escapes as text, use "<tvar name=1><syntaxhighlight inline lang="html">&</syntaxhighlight></tvar>" to replace the "&" character (eg. type "<tvar name=2><syntaxhighlight inline lang="html">&nbsp;</syntaxhighlight></tvar>", which results in "<tvar name=3><syntaxhighlight inline lang="html"> </syntaxhighlight></tvar>").

Other formatting

Beyond the text formatting markup shown hereinbefore, here are some other formatting references: </translate>

<translate>

  • LanguageConverter markup – see <tvar name=1>Template:Ll</tvar></translate>

<translate>

  • References – see <tvar name=1>Template:Ll</tvar>
  • [[<tvar name=tables>Special:MyLanguage/Help:Tables</tvar>|Tables]]

</translate>

<translate> You can find more references at <tvar name=1>Template:Ll</tvar>.

References

</translate> <references/>

[[Category:Help{{#translation:}}|Formatting]]