ESL.WikiESL.Wiki

English as a Second Language Wikibook

User Tools

Site Tools


Basic Wiki Markup Syntax

More details on some of the wiki markup elements can be found in the reference section «Wikibook's Manual».

Text Formatting

Markup Result
**bold** bold
//italic// italic
__underlined__ underlined
''monospaced'' monospaced
**//__''combined''__//** combined
<sup>superscript</sup> and <sub>subscript</sub> superscript and subscript
<del>struckout</del> struckout

Paragraphs & Line Breaks

Paragraphs are created after a blank line. If you want to force a line break without creating a paragraph, insert two backslashes "\\" followed by a space or newline.

This is just text with line breaks
Please note that two backslashes only work at the end of a line
or if there is a
space behind them. If you don't put it, \\will turn out like this.

Wiki markup:
This is just text with line breaks \\ Please note
that two backslashes only work at the end of a line \\
or if there is a \\ space behind them. If you don't put it, \\will turn out like this.

:!: Use forced line breaks only when absolutely necessary.

Headings (sectioning)

You can use up to five levels of headings to structure your text.

Wiki markup:
====== Document Title ======
===== 2nd Level Heading =====
==== 3rd Level Heading ====
=== 4th Level Heading ===
== 5th level heading ==

If there are more than three headings in the text, a list of contents is automatically created, it can be turned off by inserting the string ~~NOTOC~~ into the document.

Four or more dashes ---- are converted to a horizontal bar:


Typographic symbols

Some typographic symbols can be created by simple text characters. Here is an example of recognized characters.

→ ← ↔ ⇒ ⇐ ⇔ » « – — '640x480' © ™ ® …
"Vladimir Vladimirovich™ is our everything. © Ia"

Wiki markup:
-> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ...\\
"Vladimir Vladimirovich(tm) is our everything. (c) Ia"
External links
https://duckduckgo.com https://duckduckgo.com
[[https://duckduckgo.com|"DuckDuckGo: Confidential search engine"]] "DuckDuckGo: Confidential search engine"
[[mailto:foo@example.com|Mr. Foo]] Mr. Foo
Internal links
[[en:grammar:Present Continuous]] Present Continuous
[[en:grammar:present_continuous]] present_continuous
[[en:grammar:present_continuous|Link to "Present Continuous"]] Link to "Present Continuous"

See also Pages & Namespaces.

Interwiki Links are quick links to other Wikis. For example this is a link to Wikipedia's page about Wikis: Wiki or About Wikis.

Wiki markup:
Interwiki Links are quick links to other Wikis.
For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]] or [[wp>Wiki|About Wikis]].

Internal interwiki link to a user page: jl_Alice.

Wiki markup:
Internal interwiki link to a user page: [[user>jl_Alice]].

For more information on supported interwiki see "Interwiki".

Lists

Wiki markup supports numbered and bulleted lists. To create a list item, precede a line with two spaces followed by an asterisk (*) for a bulleted list, or a hyphen (-) for a ordered list.

  • The first item in the bulleted list
    • The second nested item in the list
      • One more nested item
    • One more list item
    • Interruptible list

      • Nested list item

      Continuation of the interruptible list

      • Another nested list item
  1. The same list, only ordered
  2. The second list item
    1. The nested item in the list
    2. Interruptible ordered list

      1. Nested list item

      Continuation of the interruptible list

      1. Another nested list item
  3. It's simple.
Wiki markup:
  * The first item in the bulleted list
    * The second nested item in the list
      * One more nested item
    * One more list item
    ** Interruptible list
      * Nested list item 
    .. Continuation of the interruptible list
      * Another nested list item 

  - The same list, only ordered
  - The second list item
    - The nested item in the list
    -- Interruptible ordered list
      - Nested list item
    .. Continuation of the interruptible list
      - Another nested list item
  - It's simple.

Footnotes

You can add footnotes 1) by using double parentheses.

Wiki markup:
You can add footnotes ((This is a footnote)) by using double parentheses.

A footnote can be given a name 2) and refer to iit already by name3).

Wiki markup:
A footnote can be given a name ((name>This is a named footnote.))
and refer to iit already by name((name)).

The footnote name4) can be positioned before its decryption5).

Wiki markup:
The footnote name((name2)) can be positioned before
its decryption((name2>This is another named footnote.)).

For more details see: Footnotes Formatting.

Tables

The wiki supports a simple syntax to create tables. Table rows have to start and end with a | for common rows and a ^ for headers:

Heading 1 Heading 2 Heading 3
Row 2 Column 1 Row 2 Column 2 Row 2 Column 3
Row 3 Column 1 Row 3 Column 2 and 3's merger
Row 4 Column 1 Row 4 Column 2 Row 4 Column 3
Wiki markup:
^ Heading 1        ^ Heading 2         ^ Heading 3          ^
| Row 2 Column 1   | Row 2 Column 2    | Row 2 Column 3     |
| Row 3 Column 1   | Row 3 Column 2 and 3's merger         ||
| Row 4 Column 1   | Row 4 Column 2    | Row 4 Column 3     |
Heading 1 Row 1 Column 2 Row 1 Column 3
Heading 2 Row 2 Column 2 Row 1 Column 3
Heading 3 Row 3 no Columns' merger
Heading 4 Row 4 Column 2 Row 4 Column 3
Wiki markup:
^ Heading 1   | Row 1 Column 2    | Row 1 Column 3   |
^ Heading 2   | Row 2 Column 2    | Row 1 Column 3   |
^ Heading 3   | Row 3 no Columns' merger |           |
^ Heading 4   | Row 4 Column 2    | Row 4 Column 3   |

You can have rows' merger by adding ::: into the cells below the one to which they should connect.

Row 1 Column 1 Row 1 Column 2 Row 1 Column 3
Row 2 Column 1 Row 2, 3 and 4's merger Column 2 Row 2 Column 3
Row 3 Column 1 Row 3 Column 3
Row 4 Column 1 Row 4 Column 3
Wiki markup:
| Row 1 Column 1   | Row 1 Column 2                     | Row 1 Column 3   |
| Row 2 Column 1   | Row 2, 3 and 4's merger Column 2   | Row 2 Column 3   |
| Row 3 Column 1   | :::                                | Row 3 Column 3   |
| Row 4 Column 1   | :::                                | Row 4 Column 3   |

You can align the table contents, too. Just add at least two spaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text.

Table Contents Alignment
left right center
right center left
Wiki markup:
^         Table Contents Alignment         ^^^
|left          |         right|    center    |
|         right|    center    |left          |

Note: Vertical alignment is not supported.

Working with images and other files

You can include external and internal media files with curly brackets. Optionally you can specify the size of images:

Real size: cheburashka.jpg

Resize to a certain width: cheburashka.jpg

Resize to a certain width and height: cheburashka.jpg

Wiki markup:
Real size:   {{en:wiki:Cheburashka.jpg}}

Resize to a certain width:    {{en:wiki:Cheburashka.jpg?100}}

Resize to a certain width and height:  {{en:wiki:Cheburashka.jpg?200x80}}

It is possible to add a title which is displayed as a tooltip by most browsers:

This is Cheburashka.

Wiki markup:
{{en:wiki:Cheburashka.jpg|This is Cheburashka.}}

By using left or right whitespaces you can choose the alignment:

image on the left on the right on the center

Wiki markup:
{{en:wiki:Cheburashka.jpg?120x60 |image on the left}}
{{ en:wiki:Cheburashka.jpg?120x60|on the right}}
{{ en:wiki:Cheburashka.jpg?120x60 |on the center}}

By adding ?linkonly you provide a link to the media without displaying it inline:

cheburashka.jpg

Wiki markup:
{{en:wiki:Cheburashka.jpg?linkonly}}

If specifying a filename that is not a supported media format, then it will be displayed as a link instead.

No Formatting

To have The Wiki ignore the markup (i.e. not format it), either enclose it in tags <nowiki> </nowiki>, or even easier – in double percent signs %%.

It's just text that contains the address http://www.splitbrain.org/ and **formatting** – but nothing happens.

Wiki markup:
It's just text that contains the address %%http://www.splitbrain.org/%%
and %%**formatting**%% -- but nothing happens.

Code Blocks

You can include code blocks into your documents by either indenting them by at least two spaces or by using the tags <code> or <file>.

This is unformatted text, in which all spaces are preserved: like          <- this.
This is also unformatted text, in which all spaces are preserved: like          <- this.
Wiki markup:
  This is unformatted text, in which all spaces are preserved: like          <- this. 

<code>
This is also unformatted text, in which all spaces are preserved: like          <- this.
</code>

Comments in markup

It is possible to insert comments into the text markup, which are displayed only when editing the page.

Wiki markup:
It is possible to insert comments into the text markup, /* like this */
which are displayed only when editing the page.

1) This is a footnote
2), 3) This is a named footnote.
4), 5) This is another named footnote.

Discussion

Enter your comment. Wiki syntax is allowed:
  _      __ ______   ___    ____   _  __
 | | /| / //_  __/  / _ \  /  _/  | |/_/
 | |/ |/ /  / /    / // / _/ /   _>  <  
 |__/|__/  /_/    /____/ /___/  /_/|_|