Revision 11 - 2009-03-09 at 20:08:27

=toc

h1. MojoMojo Cheatsheet

In MojoMojo, you can write wiki pages using HTML and one of two popular "lightweight markup languages":http://en.wikipedia.org/wiki/Lightweight_markup_language: Textile and Markdown. While you must currently choose between Textile and Markdown when creating your wiki, HTML is always available, for a few "good reasons":http://www.fileformat.info/news/2005/03/04/humane_text_formats.htm.

h2. Choosing between Textile2 and MultiMarkdown

"Textile2":http://bradchoate.com/mt/docs/mtmanual_textile2.html is an extension to Textile. "MultiMarkdown":http://fletcherpenney.net/multimarkdown/users_guide/multimarkdown_syntax_guide/ is an extension to "Markdown":http://daringfireball.net/projects/markdown/syntax, adding support for

Textile2 can't render blockquotes in lists because the "bq." block signature requires being surrounded by blank lines, and blank lines break lists:

First,

Avoid problems, and you'll never be the one who overcame them. -- Richard Bach

Second,

There is no elevator to success. You have to take the stairs.

"Markdown's documentation":http://daringfireball.net/projects/markdown/syntax#list explicitly tells how to "put a blockquote within a list item".

Generally, Markdown is more powerful, and Textile is simpler. The most common differences between them are:

  • link syntax * Textile: "Link text":http://example.com * Markdown: [Link text](http://example.com)
  • emphasis * Textile: *bold, _italic_ * Markdown: *italic ('em'), *bold* ('strong')
  • both Textile2 and MultiMarkdown have a syntax for "definition lists":http://fletcherpenney.net/multimarkdown/users_guide/multimarkdown_syntax_guide/#definitionlists but MojoMojo currently doesn't support the MultiMarkdown syntax.
  • backslash-escaping: Textile can't escape characters (you have to use their HTML code, e.g. @*@ for a '*'. In Markdown, you just write *
  • auto-hyperlinking: * Textile automatically hyperlinks URLs * Markdown: you need to enclose the URL in angle brackets: <http://mojomojo.org>

To switch MojoMojo to use MultiMarkdown, run this one-liner in the MojoMojo directory:

bc. perl -Ilib -MMojoMojo -e'MojoMojo->pref("main_formatter", "MojoMojo::Formatter::Markdown")'

h2. Cheatsheet

What you see MojoMojo "MultiMarkdown":http://fletcherpenney.net/multimarkdown/ MojoMojo Textile "Wikipedia":http://en.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page#Links_and_URLs
MojoMojo features MojoMojo [[/features]] MojoMojo [[features]]
MojoMojo editing cheatsheet MojoMojo [[/documentation/cheatsheet | editing cheatsheet]] MojoMojo [[cheatsheet | editing cheatsheet]]

h2. Table headers (broken at the moment)

Example copied from the "MultiMarkdown syntax guide":http://fletcherpenney.net/multimarkdown/users_guide/multimarkdown_syntax_guide/:

Prototype table
Grouping
First Header Second Header Third Header
Content Long Cell
Content Cell Cell
New section More Data
And more And more
My tags:
 
Popular tags:
 
Powered by Catalyst