X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/cfd750aad091e4f82593f63164f9de3bb711479f..d09bf0754f650399b7fc7227106f761ddbd24f0d:/doc/bugs/Commonmark_support.mdwn diff --git a/doc/bugs/Commonmark_support.mdwn b/doc/bugs/Commonmark_support.mdwn index 5ee014b19..cd1bd90f8 100644 --- a/doc/bugs/Commonmark_support.mdwn +++ b/doc/bugs/Commonmark_support.mdwn @@ -1,3 +1,29 @@ I suffer from the occasional markdown glitches using branchable. 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. + +> ikiwiki does not implement Markdown on its own: it uses one of several +> third-party libraries, with the current recommendation being +> Discount. Out-of-process implementations like +> [[plugins/contrib/pandoc]] are not suitable to be the default for +> performance reasons. +> +> There seems to be a Perl binding for libcmark at +> , but unfortunately +> its README points out that the libcmark API is not stable, +> which means libcmark and perl-commonmark would have to be upgraded +> in lockstep: this makes them awkward to deal with in Linux +> distributions. As a result I'm not going to look into this myself +> until there is a stable API for Commonmark available in Debian. +> +> However, if you want to add optional Commonmark support to the +> [[plugins/mdwn]] plugin, I'd review a patch. --[[smcv]] + +---- + +A very initial patch is here. There might be ikiwiki-to-commonmark option translation +to do. + +Patch: +[[!tag patch]] +[[!template id=gitbranch branch=jon/commonmark author="[[Jon]]"]]