Wikidot.com Syntax

Wikidot syntax is very powerful. Here I will just offer a few of the more useful functions.

Use The Buttons

Above the editor is a bunch of buttons. Highlight the text you want to affect and press a button. It's that easy. The button inserts the mark-up for you so you can see what to type the next time without having to switch to mouse-mode.

Add it yourself

Here are the more useful bits:

• To get bold text, just put ** before and after the text.
• To get itallic text, just put // before and after the text.
• To get underlined text, just put two underscores __ before and after the text.

Are you beginning to see a pattern here?

• To get an em-dash (— ), put two hyphens, surrounded by spaces. (If you don't surround them by spaces, you can end-up with a lot of text with strike-out. Any guesses how you get strike-out?)
• To get ^superscript and _subscript put ^^ or ,, before and after the text
• To get mono-spaced text, surround the text with {{ and }}

Lists

To get a bulletted list, put an asterisk at the beginning of the line. To indent a level, put a space before the asterisk.

* first level
 * second level
  * third level
* and back to first

Which results in:

• first level
  • second level
    • third level
• and back to first

For a numbered list, use a hash symbol instead of an asterisk

# first level
 # second level
  # third level
# and back to first

Which results in:

1. first level
   1. second level
      1. third level
2. and back to first

Headings

Headings are created by putting a number of plus symbols at the beginning of the line, with a space after the last one:

+ H1
++ H2
+++ H3
++++ H4

Which results in:

H1

H2

H3

H4

The first level heading is used at the top of the page, so you may want to start off at level 2. (++)

Pictures

The easiest way to handle pictures is to attach them to the page and then use the image wizard button.

1. Create and save the page first; you can't attach a file to a page that doesn't exist.
2. You have to be on the page you want to attach the file to, (not necessarily where you want the image, but that would be sensible.) On a thread — ie the first post on a topic — just click the File link on the thread page.
3. Down the bottom of the page… right down the bottom, there is a link "Files". Click it.
   

   A new panel will open up listing all the files that are attached to the page and offering the option to upload files. Upload all the images you want to display.

4. Now edit the comment again and use the Image Wizard. (That's the green TV screen with the twinkle) to insert the images. Select "Attached File" and chose the file you uploaded.

Quoting code

Enclose any code you need to quote in [[code]] and [[/code]], each of which must be on a line by itself, like so:

[[code]]
Put some code here.
[[/code]]

Which will result in:

Put some code here.

Yes, that box I've been using for examples is a code box.
You can highlight syntax by indicating the type of code you are quoting. [[code type="c"]] for example. It will highlight the following types: php, html, cpp, css, diff, dtd, java, javascript, perl, python, ruby, xml

Quoting People

Use "> " just like you were using email. Note that there must be a space after the last ">".

> You said
>> She said
>>> They said

Will give us:

You said

She said

They said

Note that you need to mark-up every paragraph and every blank line.

Links

There are two sorts of links. For external links use [url text]
For example [http://www.raspberrypi.org/forum The Raspberry Pi Forum] Will render as The Raspberry Pi Forum.

Going Further

The main documentation for the Wikidot syntax is here.

Otherwise, just below the editor panel is a link to "wiki text quick reference". That is handy for a quick memory jog, or the full wiki syntax is the first item on the left menu from there. That's how I get to it.

Steal Stuff

Look
Here
|
V

At the bottom of each page is that line of links I referred to earlier. If you click the right hand one, "Options", it opens up another line. One of those links is "Page Source". This lets you explore other people's pages and discover what mark-up they have used.

Go on, try it now; it's right there. — » — » — » — »