Hints On Extending

This is version 1 2 3 4 5 6 7 8 9 10 11 . It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

Creole is extensible -- the standard only specifies the core of required markup, additional markup can be added in specific wikis as needed. Most notably, there is the MixedMode, that allows to mix Creole with the wiki's native markup.

However, some wikis might choose to use Creole only, and then need some additional things. It is desirable to choose markup that doesn't conflict with Creole itself and other wikis, and to choose, where possible, markup that is popular among wikis for representing given feature.

Below are some suggestions

Markup potentially free for taking #

Inline markup #

The inline text spans are usually marked up with double characters. In case where parameters are needed, the pipe "|" character is suggested as a separator.

• ~~...~~ -- suggested for subscript text
• @@...@@
• ##...## -- suggested for inline code fragments
• $$...$$ -- suggested for LaTeX or MathML plugins
• %%...%%
• ^^...^^ -- suggested for superscript text
• &&...&&
• ((...)) -- suggested for footnotes
• __...__ -- suggested for underlined/highlighted text
• --...-- -- suggested for deleted text
• ==...== -- warning: possible collision with heading markup
• ++...++ -- suggested for added text
• ::...::
• ""..."" -- suggested for inline quotes

Block markup #

Blocks are usually marked up with at least triple characters alone on a line. It is sometimes desired for consistency reasons to have the same markup for inline elements.

• <<<...>>> -- suggested for plugins
• [[[...]]] -- suggested for qotations/poems
• """...""" -- suggested for block quotes
• $$$...$$$ -- suggested for display equations in LaTeX or MathML plugins
• @@@...@@@
• %%%...%%%
• &&&...&&&
• +++...+++
• :::...:::
• ___...___
• ///...///
• \\\...\\\
• (((...)))
• ^^^...^^^

Character markup (inline) #

This is for inserting characters that are hard to type from standard keyboards. They should be surrounded by whitespace, punctuation or appear at the beginning or end of a line.

• -- -- suggested for en dash
• --- -- suggested for em dash
• ... -- suggested for horizontal ellipsis
• `` -- suggested for left double quotation mark
• '' -- suggested for right double quotation mark
• ,, -- suggested for low double comma quotation mark
• (R) -- suggested for registered trademark sign
• (c) -- suggested for copyright sign
• (TM) -- suggested for trademark symbol
• ^2 -- suggested for superscript 2
• ^3 -- suggested for superscript 3

Special objects markup (block) #

For inserting things like separators, signatures, tables of content. This appears alone on a line.

• *** -- suggested for separators
• ~~~ -- suggested for signature
• === -- suggested for separators
• !!! -- suggested as a TODO mark

Special objects (inline) #

Some objects are characteristic enough to be detected even in flowing text.

• :) -- suggested for smiling face emoticon
• :( -- suggested for frowning face emoticon
• foo@bar.baz -- e-mail addresses can be detected and processed, but ra w urls need to have higher priority
• ISBN 123 -- links to books can be autodetected
• RFC 123 -- links to RFCs and similar documents can be autodetected
• 123.0E+123 -- scientific notation of numbers