This website uses Markdown formatting, in full compliance with the CommonMark specification, and with extensions. This page contains a guide to Markdown formatting as supported here, with recommendations on style.
Basic markup
Text may be written as plain text, with a blank line between paragraphs, and formatted using special symbols.
Emphasis
Three levels of emphasis are available, using either of the *
and _
characters: _emphasis_, **strong emphasis** or ***extra strong emphasis*** to get emphasis, strong emphasis or extra strong emphasis.
Either underscore or asterix or a combination may be used. Underscores are preserved when they appear _between_words_ as_in_here, wheres asterisks can be used when *partial*word emphasis is required: deemphasised.
Links
Write [a link to example.org](https://example.org/) to get a link to example.org. A URL may also be inserted directly, and if recognised and allowed in the context, will be converted into a link:
- As a plain URL, which works in documents but not comments: https://example.org/
- Using angle brackets to explicitly denote a link: <https://example.org/>
Lists
A list can be written using *
or -
as the first character on the line:
* List
* List
* List
- List
- List
- List
Becomes:
- List
- List
- List
For a numbered list, use 1.
or 1)
:
1. List
2. List
3. List
1) List
2) List
3) List
To get:
- List
- List
- List
Lists can be started from any number:
- List
- List
- List
Lists can be nested by indenting the sublist with three or more spaces, and can contain multiple paragraphs:
1. List item 1
With second paragraph in this list item
2. List item 2
- Sublist 1
- Sublist 2
- Sublist 3
3. List item 3
To get:
-
List item 1
With second paragraph in this list item
-
List item 2
- Sublist 1
- Sublist 2
- Sublist 3
-
List item 3
Description lists
- Term 1
- Description for both terms here