## [% loc('Markdown help') %]

- [% loc('Markdown reference - the basics') %]
- [% loc('MultiMarkdown reference - the extended syntax') %]

[% loc('Text Formatting') %]
[% loc('Text in') %] [% loc('italics') %] | [% loc('*italic* or _italic_') %]
[% loc('Text in') %] [% loc('bold') %] | [% loc('**bold** or __bold__') %]
[% loc('Links') %]

[% loc('Link to Another Page') %]

    [[[% loc('Page Name Here') %]]]

[% loc('Links to Other Sites') %]:

    [[% loc('example') %]]([% loc('http://example.com/') %])

[% loc('is formatted as:') %] [% loc('example') %]

    [[% loc('example') %]]([% loc('http://example.com/') %] "[% loc('Link Title') %]")

[% loc('is formatted as:') %] [% loc('example') %]
[% loc('hover over the link to see the title') %]

[% loc('Headers') %]

[% loc('Main Header') %]

    [% loc('Main Header') %]

    ========

[% loc('Main Header') %]

    # [% loc('Main Header') %]

[% loc('Sub Header') %]

    [% loc('Sub Header') %]

    --------

[% loc('Sub Header') %]

    ## [% loc('Sub Header') %]

    ## [% loc('Sub Header') %] ##

[% loc('optionally, you can add the same number of trailing # marks') %]

[% loc('Sub Sub ... Header') %]
[% loc('up to 6 levels of headers') %]

    ###### [% loc('Sub Sub ... Header') %]

    ###### [% loc('Sub Sub ... Header') %] ######

[% loc('Lists') %]

[% loc('To get') %]:

- Foo
- Bar

[% loc('Write') %]:

    * Foo

    * Bar

[% loc('NOTE: you need a blank line before and after the list') %]

[% loc('For numbered lists, just use numbers instead of asterisks') %]

    1. Foo

    2. Foo

[% loc('For nested lists, indent each level by 3 spaces') %]

- [% loc('Item 1') %]
  - [% loc('Item 1.1') %]
  - [% loc('Item 1.2') %]
  - [% loc('Item 1.2.1') %]
- [% loc('Item 2') %]

    * [% loc('Item 1') %]

       * [% loc('Item 1.1') %]

       * [% loc('Item 1.2') %]

          * [% loc('Item 1.2.1') %]

    * [% loc('Item 2') %]

[% loc('Block quotes') %]

    > [% loc('Just like email quoting!') %]

    > > [% loc('Blockquotes can be nested') %]

    >  ## [% loc('An h2 tag in a blockquote') %]

    >

    >  [% loc('And additional Markdown formatting') %]:

    >  * [% loc('An unordered list') %]

    >  * [% loc('Item') %]

[% loc('Horizontal Rules') %] (<hr>)

[% loc('3 or more dashes or asterisks') %]:
--- [% loc('or') %] *** [% loc('or') %] * * *

[% loc('Creates') %]:

[% loc('Code') %]
`<[% loc('code') %]>` [% loc('blocks are wrapped in backticks') %].
[% loc('Nested backticks') %]: | ``` [% loc('just use `2`') %] ``` [% loc('in the wrapping block') %]
[% loc('Preformatted Code Blocks') %] (<pre>)

[% loc('Simply indent every line of a code block by 4') %]:

    [%- loc('Normal paragraph') +%]

        [%+ loc('Spaces on the left
        render text in monospace
        like this example') +%]

    [%+ loc('Going back to normal formatting') %]

[% loc('Note that for programming language code, it may be better to use the Syntax highlight plugin.') %]

[% loc('Footnotes') %] ([% loc('details') %])
[% loc('As detailed in the book[^footnote1], we will now show that... ...later in the document... [^footnote1]: Conway, Damian - Perl Best Practices, p. 117') %]
[% loc('Images') %]
[% loc('Inline') %] | ![[% loc('alt text') %]](/image/path/file.jpg "[% loc('Optional Title') %]")