PHP Markdown Extra plugin for DokuWiki

---- plugin ----
description: Parses PHP Markdown Extra blocks.
author     : Joonas Pulakka, Jiang Le
email      : joonas.pulakka@iki.fi, smartynaoki@gmail.com
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 following URL. 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
========

~~~
some code
~~~

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}}
---

Why front matter?

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/