Welcome to 2019
[ikiwiki.git] / doc / plugins / mdwn.mdwn
1 [[!template id=plugin name=mdwn core=1 author="[[Joey]]"]]
2 [[!tag type/format]]
3
4 This plugin lets ikwiki convert files with names ending in ".mdwn" to html.
5 It uses the [[ikiwiki/markdown]] minimal markup language.
6
7 This is the standard markup language used by ikiwiki, although some others
8 are also available in other plugins.
9
10 There are several implementations of markdown support that can be used by
11 this plugin. In order of preference:
12
13 * [Discount](http://www.pell.portland.or.us/~orc/Code/discount/),
14   via the [[!cpan Text::Markdown::Discount]] perl module.
15 * The [[!cpan Text::Markdown]] perl module.
16 * The [original version of markdown](http://daringfireball.net/projects/markdown/).
17
18 [[!cpan Text::MultiMarkdown]] can be used in order to use tables, footnotes,
19 and other new features from the markdown variant called
20 [multimarkdown](http://fletcherpenney.net/MultiMarkdown/). Multimarkdown is
21 not enabled by default, but can be turned on via the `multimarkdown` option
22 in the setup file. Note that multimarkdown's metadata and wikilinks
23 features are disabled when it's used with ikiwiki.