Change Markdown parser

[mnapoli]

Problems with the current parser:

• doesn't support fenced code blocks (à la GitHub):
  • indented code blocks are a pain to write with some editors
  • syntax highlighting is random because autodetected, which leads to very weird highlighting (fenced code blocks allow to set a language explicitly)
• hacked all over the place

Parsedown is probably the best choice. The main difficulty now is try to understand what all those hacks do and see if they can be ported to Parsedown.

[mnapoli]

Here is the list of all the features added onto dflydev/markdown:

• automatic IDs on titles

• import a file, e.g.

  <pre><code markdown="1">[include url="https://raw.github.com/piwik/piwik/master/misc/others/api_rest_call.php" escape="true"]</code></pre>
  

  (with and without escaping)

• languages on codeblocks using [language]:

      [ini]
  
      [MySection]
      my_config_value = 1
  

We need to port the 2 first one, the last can be replaced by fenced code blocks.

[mattab]

👍

FYI in Marketplace Thomas changed markdown parser recently: https://github.com/piwik/piwik-marketplace/commit/46c5f164013de5a119130838057371d37636edf7 - maybe the same could be reused to KISS?

[mnapoli]

ok I didn't see that. I've used Parsedown and I'm going to stick with it for now because:

• http://parsedown.org/consistency
• http://parsedown.org/speed
• plans to support CommonMark, whereas php-markdown doesn't
• better closed/open issues ratio

[mattab]

see #34 (comment)

[mattab]

I notice in the View page linked from MVC page that there is some markdown issue:
http://developer.piwik.org//api-reference/Piwik/View <- markdown is not all processed eg

`$contentType` (`string`) —

[mnapoli]

Noted, working on it

[mnapoli]

Fixed