www/public_html/lib/plugins/markdownextra
Andy Williams 33633b9bf3 Add support for markdown format in wiki
The page name should end in .md and be stored in a file ending .md.txt
but apart from that it's exactly as you'd expect with the PHP markdown extra
https://michelf.ca/projects/php-markdown/extra/
2017-10-09 18:09:02 +01:00
..
conf Add support for markdown format in wiki 2017-10-09 18:09:02 +01:00
lang Add support for markdown format in wiki 2017-10-09 18:09:02 +01:00
lib Add support for markdown format in wiki 2017-10-09 18:09:02 +01:00
License.text Add support for markdown format in wiki 2017-10-09 18:09:02 +01:00
README.md Add support for markdown format in wiki 2017-10-09 18:09:02 +01:00
action.php Add support for markdown format in wiki 2017-10-09 18:09:02 +01:00
markdown.php Add support for markdown format in wiki 2017-10-09 18:09:02 +01:00
plugin.info.txt Add support for markdown format in wiki 2017-10-09 18:09:02 +01:00
syntax.php Add support for markdown format in wiki 2017-10-09 18:09:02 +01:00

README.md

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/