30 lines
1.5 KiB
Markdown
30 lines
1.5 KiB
Markdown
[[!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.
|