Formatting Text

When writing article text there is a simple set of formatting rules to follow in order to ensure all pages look and flow consistently. These syntax rules generally involved adding symbols before or after some plain text in order to instruct the back end website engine how to display the content in the article.

Below are some of the basic syntax rules to get started.

When editing text you will also see a grey toolbar just above the editing area, allowing you to do the more common formatting with ease.

Plain Text

Text is typed as normal, but can have additional symbols before and after words/phrases to change the format.

Text can include **bold**, //italic//, __underlined__ and ''monospaced'' texts.
Of course you can **__//''combine''//__** all these.

Produces:

Text can include bold, italic, underlined and monospaced texts. Of course you can combine all these.

You can use <sub>subscript</sub> and <sup>superscript</sup>, too.

You can use subscript and superscript, too.

You can mark something as <del>deleted</del> as well.

You can mark something as deleted as well.

Paragraphs are created from blank lines.

There are a few link types to consider

External

External links are recognized automatically: http://www.google.co.uk or simply www.google.co.uk - You can set the link text as well: This Link points to google. Email addresses like this one: info@hiddenyesterdays.uk are recognized, too.

External links are recognized automatically: http://www.google.co.uk or 
simply www.google.co.uk - You can set the link text as well: 
[[http://www.google.co.uk|This Link points to google]]. Email addresses like 
this one: <info@hiddenyesterdays.uk> are recognized, too.

Internal

An internal link is a link to another article within the Hidden Yesterdays website.

Internal links are created by using square brackets. You can either just give
a [[pagename]] or use an additional [[pagename|link text]].

Internal links are created by using square brackets. You can either just give a pagename or use an additional link text.

Footnotes

You can add footnotes 1) by using double parentheses. Footnotes appear at the bottom of an article.

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

Headings

You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically – this can be disabled by including the string ~~NOTOC~~ in the document.

Headline Level 3

Headline Level 4

Headline Level 5
==== Headline Level 3 ====
=== Headline Level 4 ===
== Headline Level 5 ==

Horizontal Line

By using four or more dashes, you can make a horizontal line:


Lists

Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a * for unordered lists or a - for ordered ones.

  • This is a list
  • The second item
    • You may have different levels
  • Another item
  * This is a list
  * The second item
    * You may have different levels
  * Another item

Tables

It is possible to present tables of data within the Article. The formatting is strict and care should be taken on the syntax. See the Table formatting article for full details.

Images

Images, especially photographs, are a great addition to an Article. There is a separate image control article covering this.

No Formatting

If you need to display text exactly like it is typed (without any automatic formatting from the symbols), enclose the area with <nowiki> tags.

<nowiki>
This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.
</nowiki>

This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.

Playground

There is a special area of the site call the 'Playground'. This allows you to create tests, or draft articles, to experiment with formatting. Note: the playground area is periodically cleared out.

Visit the playground to start experimenting.

1) This is a footnote