Fossil Wiki Rules

Formatting Rule Summary

  1. Blank lines are paragraph breaks
  2. Bullets are "*" surrounded by two spaces at the beginning of the line.
  3. Enumeration items are a number surrounded by two space at the beginning of a line.
  4. Indented pargraphs begin with a tab or two spaces.
  5. Hyperlinks are contained with square brackets: "[target]"
  6. Most ordinary HTML works.
  7. <verbatim> and <nowiki>.

We call the first five rules above "wiki" formatting rules. The last two rules are the HTML formatting rule.

Formatting Rule Details

  1. Paragraphs. Any sequence of one or more blank lines forms a paragraph break. Centered or right-justified paragraphs are not supported by wiki markup, but you can do these things if you need them using HTML.

  2. Bullet Lists. A bullet list item is a line that begins with a single "*" character surrounded on both sides by two or more spaces or by a tab. Only a single level of bullet list is supported by wiki. For nested lists, use HTML.

  3. Enumeration Lists. An enumeration list item is a line that begins with one or more digits optionally followed by a "." and is surrounded on both sides by two or more spaces or by a tab. The number is significant and becomes the number shown in the rendered enumeration item. Only a single level of enumeration list is supported by wiki. For nested enumerations or for enumerations that count using letters or roman numerials, use HTML.

  4. Indented Paragraphs. Any paragraph that begins with two or more spaces or a tab and which is not a bullet or enumeration list item is rendered indented. Only a single level of indentation is supported by wiki; use HTML for deeper indentation.

  5. Hyperlinks. Text within square brackets ("[...]") becomes a hyperlink. The target can be a wiki page name, the artifact ID of a check-in or ticket, the name of an image, or a URL. By default, the target is displayed as the text of the hyperlink. But you can specify alternative text after the target name separated by a "|" character.

  6. HTML. The following standard HTML elements may be used: <a> <address> <b> <big> <blockquote> <br> <center> <cite> <code> <dd> <dfn> <div> <dl> <dt> <em> <font> <h1> <h2> <h3> <h4> <h5> <h6> <hr> <img> <i> <kbd> <li> <nobr> <ol> <p> <pre> <s> <samp> <small> <strike> <strong> <sub> <sup> <table> <td> <th> <tr> <tt> <u> <ul> <var>. In addition, there are two non-standard elements available: <verbatim> and <nowiki>. No other elements are allowed. All attributes are checked and only a few benign attributes are allowed on each element. In particular, any attributes that specify javascript or CSS are elided.

  7. Special Markup. The <nowiki> tag disables all wiki formatting rules through the matching </nowiki> element. The <verbatim> tag works like <pre> with the addition that it also disables all wiki and HTML markup through the matching </verbatim>.