aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/mdwn.mdwn
blob: 6b20b7bb00a94fe9288c3f43295c1eeb5a41f255 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
[[!template id=plugin name=mdwn core=1 author="[[Joey]]"]]
[[!tag type/format]]

This plugin lets ikwiki convert files with names ending in ".mdwn" to html.
It uses the [[ikiwiki/markdown]] minimal markup language.

This is the standard markup language used by ikiwiki, although some others
are also available in other plugins.

There are several implementations of markdown support that can be used by
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/).

[[!cpan Text::MultiMarkdown]] can be used in order to use tables, footnotes,
and other new features from the markdown variant called
[multimarkdown](http://fletcherpenney.net/MultiMarkdown/) (some of which
are also available in the recommended implementation, Discount). 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. 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.