doc/todo/Track_Markdown_Standardisation_Efforts.mdwn

   1 Just a quick note that some people are making noise about Markdown standardisation.  Specifically:
   2
   3   * <http://markdown.github.com/>
   4   * <http://www.codinghorror.com/blog/2012/10/the-future-of-markdown.html>
   5   * <http://johnmacfarlane.net/babelmark2/faq.html#what-are-some-big-questions-that-the-markdown-spec-does-not-answer>
   6   * <http://commonmark.org/>
   7
   8 It might be worth following...
   9
  10 > ikiwiki does not implement Markdown: we use a third-party library for that
  11 > (there are several options, but the recommended one is currently
  12 > [[!cpan Text::Markdown::Discount]]). We support whatever dialect
  13 > of Markdown is implemented by the chosen Markdown implementation.
  14 >
  15 > As a result, nothing is likely to change in ikiwiki's interpretation of
  16 > Markdown unless someone either changes the behaviour of Discount,
  17 > or recommends a different (and hopefully better) third-party library.
  18 > --[[smcv]]
  19
  20 > I am not sure the noise is so much "recent" anymore: that article
  21 > announcing Commonmark is from 2012 and markdown.github.com is from
  22 > around 2014. Presumably, Commonmark will become official in 2016,
  23 > but you know what they say about [standards][]...
  24 >
  25 > I guess the only thing that Ikiwiki would need to do would be to
  26 > somewhat support Commonmark. There's a [Perl library][] that wraps
  27 > the C library, but nothing native yet.
  28 >
  29 > I guess we would need to test how it performs and compares with
  30 > Discount, but having it as a third party module is up for anyone's
  31 > grab. It should be a fairly simple implementation after all...
  32 > Then it should probably be mentionned in [this discussion][] for
  33 > everyone's benefit as well. --[[anarcat]]
  34
  35 [standards]: https://xkcd.com/927/
  36 [Perl library]: https://metacpan.org/release/CommonMark
  37 [this discussion]: https://talk.commonmark.org/t/i-wonder-if-there-is-a-wiki-engine-that-uses-markdown/1281/18