From: smcv Date: Sun, 14 May 2017 11:51:56 +0000 (-0400) Subject: recommend discount over multimarkdown X-Git-Tag: debian/3.20170622~59 X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/commitdiff_plain/65fe86e6f3544912d0fd64753aea2c5d61018e0e?ds=inline recommend discount over multimarkdown --- diff --git a/doc/plugins/mdwn.mdwn b/doc/plugins/mdwn.mdwn index 8a7308305..62d97b187 100644 --- a/doc/plugins/mdwn.mdwn +++ b/doc/plugins/mdwn.mdwn @@ -12,6 +12,9 @@ this plugin. In order of preference: * [Discount](http://www.pell.portland.or.us/~orc/Code/discount/), via the [[!cpan Text::Markdown::Discount]] perl module. + This implementation is considered to be the default and is strongly + recommended, but it is not mandatory because it requires an external + C library. * The [[!cpan Text::Markdown]] perl module. * The [original version of markdown](http://daringfireball.net/projects/markdown/). @@ -20,4 +23,6 @@ and other new features from the markdown variant called [multimarkdown](http://fletcherpenney.net/MultiMarkdown/). Multimarkdown is not enabled by default, but can be turned on via the `multimarkdown` option in the setup file. Note that multimarkdown's metadata and wikilinks -features are disabled when it's used with ikiwiki. +features are disabled when it's used with ikiwiki. Also note that if the +`multimarkdown` option is enabled, it takes priority over Discount, which +might cause formatting that is understood by Discount to be ignored.