doc/bugs/Commonmark_support.mdwn

   1 I suffer from the occasional markdown glitches using branchable.
   2
   3 I've found that switching my own non-ikiwiki projects to https://github.com/jgm/CommonMark has helped sort them out for the most part.
   4
   5 > ikiwiki does not implement Markdown on its own: it uses one of several
   6 > third-party libraries, with the current recommendation being
   7 > Discount. Out-of-process implementations like
   8 > [[plugins/contrib/pandoc]] are not suitable to be the default for
   9 > performance reasons.
  10 >
  11 > There seems to be a Perl binding for libcmark at
  12 > <https://github.com/nwellnhof/perl-commonmark>, but unfortunately
  13 > its README points out that the libcmark API is not stable,
  14 > which means libcmark and perl-commonmark would have to be upgraded
  15 > in lockstep: this makes them awkward to deal with in Linux
  16 > distributions. As a result I'm not going to look into this myself
  17 > until there is a stable API for Commonmark available in Debian.
  18 >
  19 > However, if you want to add optional Commonmark support to the
  20 > [[plugins/mdwn]] plugin, I'd review a patch. --[[smcv]]