Revision 12 - 2009-03-09 at 20:34:22

=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,

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

Second,

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

The workaround for Textile is to use HTML and avoid the line breaks.

"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