---- plugin ----
description: Parses PHP Markdown Extra blocks.
author     : Joonas Pulakka, Jiang Le
email      : [email protected], [email protected]
type       : syntax
lastupdate : 2013-01-14
compatible : 2012-10-13 “Adora Belle” and newer
depends    : 
conflicts  :
similar    : markdown 
tags       : formatting, markup_language
downloadurl: 
----

##Download and Installation

Download and install the plugin using the Plugin Manager using the URL https://github.com/ajwillia-ms/dokuwiki-plugin-markdownextra/tarball/master . Refer to [[:Plugins]] on how to install plugins manually.

##Usage

If 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:

<markdown>
Header 1
========

~~~ .c
int method() {
  return 5;
}
~~~

Paragraph

Header 2
--------

- A
- simple
- list

1. And
2. numbered
3. list

Quite intuitive? *emphasis*, **strong**, etc.
</markdown>

###Front matter Front matter is a text block at the top of dokuwiki page with .md suffix. It begins and ends with '—'. Looks like this:

---
{{tag>test}}
---

I love this markdown extra plugin, the best feature is .md suffix. And I love tag plugin too, but I can't use it with page with .md suffix as {{tag>tat1 tag2 tag3}} syntax will not work within . So I added this front matter feature.

For syntax, refer to http://michelf.com/projects/php-markdown/extra/