Markup Reference

'Markup' is a simple way to create web page content.  Starting with plain text, you can add styles like bold or italic and create full featured pages with pictures and links to other pages.

Basic rules

Any text you type in the edit window and save will show on your page.

Leave a blank line (like that above) to start a new paragraph.  Line breaks are ignored and all text within a block is treated as a paragraph.

You can add style and features to your page using markups.  All markups are denoted by square brackets [ ] with a special character immediately inside these.  For example [/show in italics/] will show as show in italics.  Some 'special' markups use double square braclets [[ ]].

Markup works between start and end points - so remember to close the brackets or the markup will continue to the end of your document!

Inline markups

New lines

render as

Back to back square brackets [] start a new line.
Otherwise text just continues... 		Back to back square brackets
start a new line. Otherwise text just continues...

Headings

render as

[~Heading~]


[~~Sub-heading~~]

the ~ character is usually shift # on your keyboard

a heading in the first line of a blog entry is used
in the 'Recent titled post' listing

Heading


Sub-heading

Text formatting

render as

[*bold*]
[/italic/]
[+big+]
[-small-]
super[^script^]
 bold
italic
big
small
superscript

Highlighting

render as

[!this phrase is highlighted!]

use to highlight key words/phrases in your page or draw attention to important items

 this phrase is highlighted

Entities

render as

['copy'] ['reg'] ['euro'] ['egrave'] ['aacute']

use to show special characters (html entities)
see Entities

 © ® € è á

Special markups

Internal page links

render as

[[Welcome]]

use page title in double square brackets
this will link to any other page on this site

 Welcome
[[Welcome|Home]]

you can give a page an 'alias' name
add the new name after a | character
the | character is usually shift \ on your keyboard

 Home

External page links

render as

[[link:http://www.bbc.co.uk]]
[[link:http://www.bbc.co.uk|The BBC]]

note use of optional | to add a site name
the | character is usually shift \ on your keyboard

 http://www.bbc.co.uk link
The BBC link

Pictures

render as

[[snap:A. cucurbitina]]

use [[picture:title]] for full width picture

you can also use [[thumb:title]] to show 'thumbnail' or small views of a picture

you can use [[credit:title]] or [[location:title]] to show the picture credit or location information

You can use [[snap:title|right]] or [[snap:title|left]] to 'float' a picture within paragraph text

 A. cucurbitina

Lists

Simple lists

render as

[_
Item 1
Item 2
...etc
_]

underscore _ is usually shift - on your keyboard
  • Item 1
  • Item 2
  • ...etc

Bulleted lists

render as

[.
Item 1
Item 2
...etc
.]
  • Item 1
  • Item 2
  • ...etc

Numbered lists

render as

[#
Item 1
Item 2
...etc
#]
  1. Item 1
  2. Item 2
  3. ...etc

Page layout

Centring

render as

[%this text is centred%]

[%
[[thumb:A. cucurbitina]]
%]

you can centre text, pictures or any other object
this text is centred

A. cucurbitina

Block quotes

render as

["
this is a block quote, with right and left indents
"]
this is a block quote, with right and left indents

Other markups

Escape/ignore markup

render as

{{markup in [/this/] section [*will*] be ignored}}

use double curly brackets if you need to prevent markup rendering

 markup in [/this/] section [*will*] be ignored