=toc
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:
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.
"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/:
| Grouping | ||
|---|---|---|
| First Header | Second Header | Third Header |
| Content | Long Cell | |
| Content | Cell | Cell |
| New section | More | Data |
| And more | And more | |
Showing changes from previous revision. Removed | Added
