2.4 Wikitext editing

Revision as of 11:30, 27 April 2022

Wikitext is a simplified markup language that is used to format and structure text and other data.

While HTML is the most common markup language for web pages, Wikitext is used in wiki systems. Like HTML, it uses tags to mark parts of text or other data.

How do I use Wikitext?

When you edit a page, you can switch between visual editing and source editing using the editor toolbar.

Screenshot: Visual Editor switch edit mode

Wikitext can be entered in source editing mode. When you are in visual editing mode, VisualEditor inserts Wikitext "behind the scenes". If VisualEditor doesn't format elements on a page correctly, you can always switch to source editing to correct the issues directly in Wikitext.

Examples of Wikitext

Here are some typical examples of Wikitext:

Text formatting

This is '''bold'''
This is ''italic''
This is <u>underlined</u>

Structuring

This is a ==Heading==
This is an *unordered list element

Table:

{| class="wikitable"
|-
!header 1
!header 2
|-
|row 1, cell 1
|row 1, cell 2
|-
|row 2, cell 1
|row 2, cell 2
|}

Links / Embedded files

Link to internal wiki page

[[Wikipage|Label]]
[[Pancake|Best Pancake]]

Link to external website

[url label]
[https://wikipedia.org Wikipedia]

'Link with parameters

<span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}|action=edit}} Edit this page]</span>

This link opens the referenced page in edit mode in a new tab.

Embed image/file

[[Datei:image-or-pdf-name.png]] - - - Image/PDF is embedded on page
- the wiki checks, if a preview can be generated (e.g., for "png", "jpeg", "gif", "svg") and embeds the preview
- otherwise, a link to the file description page is created
  - can be embedded: PDF, Tiff (with extension)
  - cannot be embedded: Microsoft Office- und Libre Office-Dateien; Shell-Skripte, ...
[[Media:image-or-pdf--name.png]] - - - - Links to image / PDF
[[:Datei:image-or-pdf--name.png]] - - - Links to file description page

Magic words

Type of Wikitext	Example
Special character	`ã` → ã `ç` → ç UTF-8 is possible
Comment	`<!-- unnoticed -->`
No "wiki translation"	`<nowiki>` and `</pre>`
Table of contents	`__TOC__` and `__NOTOC__`
Signature	`--~~~`
Redirect	`#REDIRECT [[targetpage]]`
Template	`{{template name}}`

Related info

To submit feedback about this documentation, visit our community forum.

@@ Line 1: / Line 1: @@
 <bookshelf src="Book:User manual" />
+<section begin="training-intro" /><div class="training">
+Wikitext is a simplified markup language that is used to format and structure text and other data. <section end="training-intro" /><section end="training-intro" />
+While HTML is the most common markup language for web pages, Wikitext is used in wiki systems. Like HTML, it uses tags to mark parts of text or other data.
+==How do I use Wikitext?==
+When you edit a page, you can switch between visual editing and source editing using the editor toolbar.
+[[File:Manual:editing.png|alt=Screenshot: Visual Editor switch edit mode|center]]
+Wikitext can be entered in source editing mode. When you are in visual editing mode, VisualEditor inserts Wikitext "behind the scenes". If VisualEditor doesn't format elements on a page correctly, you can always switch to source editing to correct the issues directly in Wikitext.<br />
+==Examples of Wikitext==
+Here are some typical examples of Wikitext:
+<section begin="training" />
+===Text formatting===
+<section begin="training-slide1" />
+*This is <code><nowiki>'''bold'''</nowiki></code>
+*This is <code><nowiki>''italic''</nowiki></code>
+*This is <code><nowiki><u>underlined</u></nowiki></code><section end="training-slide1" />
+===Structuring===
+<section begin="training-slide2" />
+*This is a <code>==Heading==</code>
+*This is an <code>*unordered list element</code>
+*Table:<syntaxhighlight lang="text">
+{| class="wikitable"
+|-
+!header 1
+!header 2
+|-
+|row 1, cell 1
+|row 1, cell 2
+|-
+|row 2, cell 1
+|row 2, cell 2
+|}</syntaxhighlight><section end="training-slide2" />
+===Links / Embedded files===
+<section begin="training-slide3" />
+'''Link to internal wiki page'''
+<syntaxhighlight lang="text">
+[[Wikipage|Label]]
+[[Pancake|Best Pancake]]
+</syntaxhighlight>
+'''Link to external website'''
+<syntaxhighlight lang="text">
+[url label]
+[https://wikipedia.org Wikipedia]
+</syntaxhighlight>
+'''Link with parameters''
+<syntaxhighlight lang="text">
+<span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}|action=edit}} Edit this page]</span>
+</syntaxhighlight>
+This link opens the referenced page in edit mode in a new tab.
+<section end="training-slide3" />
+'''Embed image/file'''
+<br />
+<section begin="training-slide4" />
+*<code>[['''Datei:'''<nowiki>image-or-pdf-name.png]]</nowiki></code> - - - '''Image/PDF is embedded on page'''<section end="training-slide4" />
+**the wiki checks, if a preview can be generated (e.g., for "png", "jpeg", "gif", "svg") and embeds the preview
+**otherwise, a link to the file description page is created
+***can be embedded: PDF, Tiff (with extension)
+***cannot be embedded: Microsoft Office- und Libre Office-Dateien; Shell-Skripte, ...<section begin="training-slide4" />
+*<code>[['''Media:'''<nowiki>image-or-pdf--name.png]]</nowiki></code> - - - - '''Links to image / PDF'''
+*<code>[[''':Datei:'''<nowiki>image-or-pdf--name.png]]</nowiki></code> - - - '''Links to file description page'''
+<section end="training-slide4" /></div>
+<section end="training" />
+===Magic words===
+{| class="contenttable"
+!Type of Wikitext
+!Example
+|-
+|Special character
+|'''<code>&amp;atilde;</code>  &rarr; &atilde;'''
+'''<code>&amp;ccedil;</code> &rarr; &ccedil;'''
+UTF-8 is possible
+|-
+|Comment
+|<code>'''<nowiki><!-- unnoticed --></nowiki>'''</code>
+|-
+|No "wiki translation"
+|<code>'''&lt;nowiki'''&gt;</code> and <code>'''</pre'''></code>
+|-
+|Table of contents
+|<code>'''<nowiki>__TOC__</nowiki>'''</code> and <code>'''<nowiki>__NOTOC__</nowiki>'''</code>
+|-
+|Signature
+|<code>'''<nowiki>--~~~</nowiki>'''</code>
+|-
+|Redirect
+|<code>'''<nowiki>#REDIRECT [[targetpage]]</nowiki>'''</code>
+|-
+|Template
+|<code>'''<nowiki>{{template name}}</nowiki>'''</code>
+|}
+<section end="wikitextTraining" />
+{{Box Links-en
+|Topic1=[https://meta.wikimedia.org/wiki/Help:Wikitext_examples  meta.wikimedia.org/wiki/Help:Wikitext_examples]
+|Topic2=[[MagicWords|Magic words]]}}
+[[en:{{FULLPAGENAME}}]]
+[[de:Wikitext]]
+[[Category:Editing]]