The syntax of items on this site may have the following structure:
You can't write HTML here - it was written for users who wouldn't get that right.
- Paragraphs
- A carriage return at the end of each paragraph (soon this will be two returns to break a paragraph).
- Horizontal Rules
- Two or more dashes alone on a line become a horizontal rule
- Typography
- "--" and "---" will be converted into en-dash and em-dash respectively. (It is quite conservative about when it converts, and currently expects numbers or spaces on both sides.)
- Linking
- Email addresses foo@example.com are linked automatically
- (HTTP/HTTPS/FTP) Web addresses get converted to links:
- Name links by putting them in pointy brackets, followed by the link text. Example flibble is "http://example.com/ Example flibble" in pointy brackets
- Internal links
- Use space-slash-itemname-slash-space - e.g. " /foo/bar/? ".
- The slashes need to be forward-slashes "/", not back-slashes "\".
- You may also have a single full-stop, apostrophe or comma between the final slash and the space, to allow the construction of half-decent sentences.
- You may use relative links – i.e. beginning with "./" for under this article, and "../" for the parent article.
- You can make a list of all the articles just underneath the one you are editing by putting "* ./*/" on a line. The first star is to denote a list, the second star will match against a single term in the URL. Other related patterns may follow.
- Bulleted Lists
- Begin each line with star-space or dash-space (i.e. "* " or "- ")
- Numbered lists
- Begin each line with hash-space (i.e. "# ")
- Change the type of the ordered bullet by putting A, a, I or i after the # for alphabetic or roman numerals (upper or lower case).
- Definition lists
- Begin definition terms with colon-space (': ')
- Follow a term with any number of lines for definitions beginning with colon-colon-space.
- Headings
- Start lines with >, followed by a space.
- Use multiple >'s for lower subheads, but please try to use them in order (don't jump from '>' to '>>>', for example).
- Label a section with a word in square brackets before the >'s. e.g. If you want to link to the section as …#example put [example] before the >'s.
- Quoting code
- Begin each line with '%', and the rest will remain unadulterated.
Current misbehaviours/annoyances in the markup