aboutsummaryrefslogtreecommitdiff
path: root/doc/bugs
diff options
context:
space:
mode:
authorhttp://smcv.pseudorandom.co.uk/ <smcv@web>2015-03-30 07:09:33 -0400
committeradmin <admin@branchable.com>2015-03-30 07:09:33 -0400
commit3b27d8fafaf382cee9c8ce6be426c601588e5503 (patch)
tree67f5b66933c4f30887b8948609684e7bb285f19b /doc/bugs
parent11a67ae321e812c3b3bfb87f1a404d7c3c13b909 (diff)
downloadikiwiki-3b27d8fafaf382cee9c8ce6be426c601588e5503.tar
ikiwiki-3b27d8fafaf382cee9c8ce6be426c601588e5503.tar.gz
respond
Diffstat (limited to 'doc/bugs')
-rw-r--r--doc/bugs/Commonmark_support.mdwn17
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]]