PHP Markdown Extra plugin for DokuWiki

---

About this fork:

I've switched the markdown engine to cebe-markdown as I ran into problems with e.g. nested bullet lists and citations in php-markdown-extra.

--Olf

---

---- 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 <markdown></markdown>. So I added this front matter feature.

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