X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/79532db9ae80f506597d6fd9ffe59ff793198e4f..651cdd4b2a85f4e5f9d298a7eea7d0e6d94442b1:/doc/todo/Track_Markdown_Standardisation_Efforts.mdwn?ds=sidebyside

diff --git a/doc/todo/Track_Markdown_Standardisation_Efforts.mdwn b/doc/todo/Track_Markdown_Standardisation_Efforts.mdwn
index 54a615920..90aba7a25 100644
--- a/doc/todo/Track_Markdown_Standardisation_Efforts.mdwn
+++ b/doc/todo/Track_Markdown_Standardisation_Efforts.mdwn
@@ -3,5 +3,35 @@ Just a quick note that some people are making noise about Markdown standardisati
   * <http://markdown.github.com/>
   * <http://www.codinghorror.com/blog/2012/10/the-future-of-markdown.html>
   * <http://johnmacfarlane.net/babelmark2/faq.html#what-are-some-big-questions-that-the-markdown-spec-does-not-answer>
+  * <http://commonmark.org/>
 
 It might be worth following...
+
+> ikiwiki does not implement Markdown: we use a third-party library for that
+> (there are several options, but the recommended one is currently
+> [[!cpan Text::Markdown::Discount]]). We support whatever dialect
+> of Markdown is implemented by the chosen Markdown implementation.
+>
+> As a result, nothing is likely to change in ikiwiki's interpretation of
+> Markdown unless someone either changes the behaviour of Discount,
+> or recommends a different (and hopefully better) third-party library.
+> --[[smcv]]
+
+> I am not sure the noise is so much "recent" anymore: that article
+> announcing Commonmark is from 2012 and markdown.github.com is from
+> around 2014. Presumably, Commonmark will become official in 2016,
+> but you know what they say about [standards][]...
+>
+> I guess the only thing that Ikiwiki would need to do would be to
+> somewhat support Commonmark. There's a [Perl library][] that wraps
+> the C library, but nothing native yet.
+>
+> I guess we would need to test how it performs and compares with 
+> Discount, but having it as a third party module is up for anyone's
+> grab. It should be a fairly simple implementation after all...
+> Then it should probably be mentionned in [this discussion][] for 
+> everyone's benefit as well. --[[anarcat]]
+ 
+[standards]: https://xkcd.com/927/
+[Perl library]: https://metacpan.org/release/CommonMark
+[this discussion]: https://talk.commonmark.org/t/i-wonder-if-there-is-a-wiki-engine-that-uses-markdown/1281/18