diff options
| author | http://smcv.pseudorandom.co.uk/ <smcv@web> | 2015-03-30 07:09:33 -0400 |
|---|---|---|
| committer | admin <admin@branchable.com> | 2015-03-30 07:09:33 -0400 |
| commit | 3b27d8fafaf382cee9c8ce6be426c601588e5503 (patch) | |
| tree | 67f5b66933c4f30887b8948609684e7bb285f19b /doc/bugs/Commonmark_support.mdwn | |
| parent | 11a67ae321e812c3b3bfb87f1a404d7c3c13b909 (diff) | |
| download | ikiwiki-3b27d8fafaf382cee9c8ce6be426c601588e5503.tar ikiwiki-3b27d8fafaf382cee9c8ce6be426c601588e5503.tar.gz | |
respond
Diffstat (limited to 'doc/bugs/Commonmark_support.mdwn')
| -rw-r--r-- | doc/bugs/Commonmark_support.mdwn | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/doc/bugs/Commonmark_support.mdwn b/doc/bugs/Commonmark_support.mdwn index 5ee014b19..b05f67f12 100644 --- a/doc/bugs/Commonmark_support.mdwn +++ b/doc/bugs/Commonmark_support.mdwn @@ -1,3 +1,20 @@ 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 +> <https://github.com/nwellnhof/perl-commonmark>, 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]] |