h2.

Choosing between Textile2 and MultiMarkdown

"Textile2":http://bradchoate.com/mt/docs/mtmanual_textile2.html is an extension to Textile., adding extended blocks (blocks that can contain a newline). "MultiMarkdown":http://fletcherpenney.net/multimarkdown/users_guide/multimarkdown_syntax_guide/ is an extension to "Markdown":http://daringfireball.net/projects/markdown/syntax, adding support for tables, footnotes, bibliography, automatic cross-references, glossaries, appendices, definition lists, math syntax, anchor and image attributes, and document metadata. etc.

One major problem with Textile2 can'tis that newlines break lists. It thus becomes impossible to render blockquotes or blocks of code in lists because the "bq." or "bc." block signature requires being surrounded by blank lines, and blank lines break lists:

The workaround for Textile is to usefallback HTMLto and avoid the line breaksHTML.

"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 mostbasic common differences between themthe two syntaxes are:

• link syntax *
  • Textile: "Link text":http://example.com
  *
  • Markdown: [Link text](http://example.com)
• emphasis *
  • Textile: *bold*, _italic_
  *
  • Markdown is more semantic: *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>
• both Textile2 and MultiMarkdown have a syntax for definition lists but MojoMojo currently doesn't support the MultiMarkdown syntax.
• pipe characters in text within table cells must be escaped as | (backslash-escaping doesn't work in this case with MultiMarkdown). MultiMarkdown allows linebreaks in tables after the first row.

To switch MojoMojo to use MultiMarkdownTextile, rungo thisto one-liner in the MojoMojoEdit directory:Settings page.

h2.Wikilinks Cheatsheetare interpreted by MojoMojo separately and have the same syntax, regardless of the formatter being Textile2 or MultiMarkdown:

h2. MojoMojo Tableediting headerscheatsheet MojoMojo (broken[[/documentation/cheatsheet | atediting thecheatsheet]] MojoMojo moment)

Example

Table copiedheaders fromand thecell "MultiMarkdown syntax guide":http://fletcherpenney.net/multimarkdown/users_guide/multimarkdown_syntax_guide/:

alignment