h1. MojoMojo Cheatsheet
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:
bq. Avoid problems, and you'll never be the one who overcame them. -- Richard Bach
bq. 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")'
|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/:
|First Header||Second Header||Third Header|
|And more||And more|
Showing changes from previous revision.