Markdown Formatting Rules


Paragraphs are divided by blank lines.
End a line with two or more spaces to force a mid-paragraph line break.


# Top Level Heading                 Alternative Top Level Heading
# Top Level Heading Variant #       =============================

## 2nd Level Heading                Alternative 2nd Level Heading
## 2nd Level Heading Variant ##     -----------------------------

### 3rd Level Heading               ### 3rd Level Heading Variant ###
#### 4th Level Heading              #### 4th Level Heading Variant ####
##### 5th Level Heading             ##### 5th Level Heading Variant #####
###### 6th Level Heading            ###### 6th Level Heading Variant ######


  1. [display text](URL)
  2. [display text](URL "Title")
  3. [display text](URL 'Title')
  4. <URL>
  5. [display text][label]
  6. [display text][]
  7. [display text]

URL may optionally be written <URL>. With link formats 5, 6, and 7 ("reference links"), the URL is supplied elsewhere in the document, as shown below. Link formats 6 and 7 reuse the display text as the label. Labels are case-insensitive. The title may be split onto the next line with optional indenting.

  • [label]: URL
  • [label]: URL "Title"
  • [label]: URL 'Title'
  • [label]: URL (Title)


  • *italic*
  • _italic_
  • **bold**
  • __bold__
  • ***italic+bold***
  • ___italic+bold___
  • `code`

The `code` construct disables HTML markup, so one can write, for example, `<html>` to yield <html>.


 *   bullet item
 +   bullet item
 -   bullet item
 1.  numbered item
 2)  numbered item

A two-level list is created by placing additional whitespace before the */+/-/1. of the secondary items.

 *   top-level item
   * secondary item

Block Quotes

Begin each line of a paragraph with > to block quote that paragraph.

> This paragraph is indented

> > Double-indented paragraph

Literal/Verbatim Text

There are several ways to write text in Markdown that should be rendered without any special interpretation.

For inline text, you can either use `backticks` or the HTML <code> tag.

For blocks of text, there are several methods:

  1. Indent the text using a tab character or at least four spaces.
  2. Precede the block with an HTML <pre> tag and follow it with </pre>.
  3. Surround the block in triple backticks (```) either at the left margin or indented no more than three spaces.

Note that unlike in GitHub-Flavored Markdown, Fossil does not currently support any “info string” in fenced code blocks after the opening sequence, including language tags

With the standard skins, verbatim text is rendered in a fixed-width font, but that is purely a presentation matter, controlled by the skin’s CSS.


| Header 1     | Header 2    | Header 3      |
| Row 1 Col 1  | Row 1 Col 2 | Row 1 Col 3   |
|:Left-aligned |:Centered   :| Right-aligned:|
|              | ← Blank   → |               |
| Row 4 Col 1  | Row 4 Col 2 | Row 4 Col 3   |

The first row is a header if followed by a horizontal rule or a blank line.

Placing : at the left, both, or right sides of a cell gives left-aligned, centered, or right-aligned text, respectively. By default, header cells are centered, and body cells are left-aligned.

The leftmost or rightmost | is required only if the first or last column, respectively, contains at least one blank cell.


  • In-line images are made using ![alt-text](image-URL).
  • Use HTML for advanced formatting such as forms.
  • <!-- HTML-style comments --> are supported.
  • Escape special characters (ex: [ ( | *) using backslash (ex: \[ \( \| \*).
  • A line consisting of ---, ***, or ___ is a horizontal rule. Spaces and extra -/*/_ are allowed.
  • See for additional information.
  • See this page's Markdown source for complex examples.

Special Features For Fossil

  • In hyperlinks, if the URL begins with / then the root of the Fossil repository is prepended. This allows for repository-relative hyperlinks.
  • For documents that begin with a top-level heading (ex: # heading #), the heading is omitted from the body of the document and becomes the document title displayed at the top of the Fossil page.