1# PHP Markdown Extra plugin for DokuWiki
2    ---- plugin ----
3    description: Parses PHP Markdown Extra blocks.
4    author     : Joonas Pulakka, Jiang Le
5    email      : joonas.pulakka@iki.fi, smartynaoki@gmail.com
6    type       : syntax
7    lastupdate : 2013-01-14
8    compatible : 2012-10-13 “Adora Belle” and newer
9    depends    :
10    conflicts  :
11    similar    : markdown
12    tags       : formatting, markup_language
13    downloadurl:
14    ----
15
16##Download and Installation
17
18Download and install the plugin using the Plugin Manager using the following URL. Refer to [[:Plugins]] on how to install plugins manually.
19
20
21
22##Usage
23
24If the page name ends with ''.md'' suffix, it gets automatically parsed using PHP Markdown Extra. To use that markup in other pages, the content must be embedded in a markdown block. For example:
25
26    <markdown>
27    Header 1
28    ========
29
30    ~~~
31    some code
32    ~~~
33
34    Paragraph
35
36    Header 2
37    --------
38
39    - A
40    - simple
41    - list
42
43    1. And
44    2. numbered
45    3. list
46
47    Quite intuitive? *emphasis*, **strong**, etc.
48    </markdown>
49
50
51###Front matter
52Front matter is a text block at the top of dokuwiki page with .md suffix. It begins and ends with '—'. Looks like this:
53
54    ---
55    {{tag>test}}
56    ---
57
58
59#### Why front matter?
60I love this markdown extra plugin, the best feature is .md suffix. And I love [tag plugin](https://www.dokuwiki.org/plugin:tag) too, but I can't use it with page with .md suffix as {{tag>tat1 tag2 tag3}} syntax will not work within <markdown></markdown>. So I added this front matter feature.
61
62
63For syntax, refer to http://michelf.com/projects/php-markdown/extra/