Creole Syntax

Contents[+]
  1. Creole Syntax[+]
    1. Headings[+]
      1. heading 3rd level[+]
        1. heading 4th level[+]
          1. heading 5th level
    2. Text Formatting
    3. Lists[+]
      1. Unordered Lists
      2. Ordered Lists
    4. Horizontal Rule
    5. Tables
    6. Linebreak
    7. No Wiki Markup
    8. Macros[+]
      1. FootNotes

Creole is a wiki markup language that has a goal of becoming a common wiki syntax that will enable better exchange of content between different wiki engines.

This page introduces you to the most important elements of the creole syntax. Under each heading within a shaded box is the verbatim markup followed by the output as rendered by the wiki engine. The display of some of the features depends upon your wiki configuration and choice of theme.

BTW: This very page is written in creole syntax!

Features currently not working with moin's Creole parser are marked with CREOLETODO:

Headings

Markup:

=== heading 3rd level ===
==== heading 4th level ====
===== heading 5th level =====

Result:

heading 3rd level

heading 4th level

heading 5th level

Text Formatting

Markup:

* //emphasized (italics)//
* **boldface**
* __underlined__
* **//bold italics//**, //**italics bold __underlined__**//
* {{{monospace}}}

Result:

  • emphasized (italics)
  • boldface
  • underlined
  • bold italics, italics bold underlined
  • monospace

Note this item is in the "help-en" namespace. Within link syntax, namespaces are processed like ordinary parent items.

The declaration for a link looks like:

    [[url|link text]]

Within MoinWiki and Creole syntax:

  • a simple link like `Home` links to an item in the default namespace
  • a relative link like `../Home` links to a sibling in the current namespace
  • a link that begins with a namespace like `users/Home` links to the Home item in the target namespace
  • a link beginning with / like `/subitem` links to a subitem of the current item

Markup:

* [[Home|Home in default namespace]]
* [[help-en/Home/subitem]]
* [[/MissingSubItem]]
* [[../moin|sibling item]]
* [[help-en/Home|go to help-en/Home]]
* [[#Internal_Links|click to scroll top of page to Internal Links]]
* [[MissingPage]]
* [[help-en/Home|{{help-common/logo.png}} Go **Home**]]

Result:

Markup:

* https://moinmo.in/
* [[https://moinmo.in/]]
* [[https://moinmo.in/|MoinMoin Wiki]]
* [[https://static.moinmo.in/logos/moinmoin.png]]
* [[https://static.moinmo.in/logos/moinmoin.png|moinmoin.png]]
* [[MeatBall:InterWiki|InterWiki page on **MeatBall**]]
* [[file://///servername/share/full/path/to/file/filename%20with%20spaces.txt|link to file filename with spaces.txt]]
* [[https://moinmo.in|{{help-common/logo.png}} Go to **moinmo.in**]]
* [[mailto:joe@doe.com|email me]]

Result:

Images (transclusions)

Creole syntax does not provide a means to position or resize images.

Markup:

# {{help-common/logo.png}}
# {{help-common/logo.svg|my svg}}
# {{http://static.moinmo.in/logos/moinmoin.png}}
# {{http://www.xkcd.com/}}

Result:

  1. help-common/logo.png
  2. my svg
  3. http://static.moinmo.in/logos/moinmoin.png
  4. http://www.xkcd.com/

Avoid or Limit Automatic Linking

Markup:

 * {{{https://www.example.com}}}
 * ~https://www.example.com/

Result:

  • https://www.example.com
  • https://www.example.com/

Lists

Unordered Lists

Markup:

* item 1

* item 2 (preceding white space)
** item 2.1
*** item 2.1.1
* item 3

Result:

  • item 1
  • item 2 (preceding white space)
    • item 2.1
      • item 2.1.1
  • item 3

Ordered Lists

Markup:

# item 1
## item 1.1
## item 1.2
# item 2

Result:

  1. item 1
    1. item 1.1
    2. item 1.2
  2. item 2

Horizontal Rule

Markup:

----

Result:

Tables

Creole has an unusual feature that allows table headings to be placed on either rows or columns. The trailing "|" character at the end of a table row is optional.

Markup:

|=A |=B |=C |
| 1 | 222 | 33333 |

|=X|1
|=Y|123
|=Z|12345

Result:

ABC
122233333
X1
Y123
Z12345

Linebreak

Markup:

forced\\linebreak

Result:

forced
linebreak

No Wiki Markup

Markup:

 {{{
 Enclose
       preformatted
                  code
                     in triple curly brackets
 }}}

Result:

Enclose
      preformatted
                 code
                    in triple curly brackets

Macros

Macros are extensions to standard Creole markup that allow developers to add extra features. See ../MoinWikiMacros for a list of all macros.

FootNotes

Markup:

Footnotes can be placed by using the macro syntax.<<FootNote(A macro is enclosed in double angle brackets.)>>

Result:

Footnotes can be placed by using the macro syntax. 1

1 A macro is enclosed in double angle brackets.