markdown.inc.php

Port Markdown Text Markup Syntax to PukiWiki

This page is written in both English and Japanese.

Abstract

This plugin enables to write parts or whole of a Pukiwiki page within Markdown syntax. I will not use this plugin by myself, but I created this plugin to introduce that it is easily realized to write Pukiwiki more than Pukiwiki syntax.

Technical Details

The mechanism is simple, this plugin just passes the text of argument to PHP Markdown and returns the generated HTML code.

However, Markdown passes through HTML tags directly, therefore, texts are passed into Markdown engine after HTML tags are html encoded in usual pages.

On pages which are frozen or edit_authed or when whole system is working under PKWK_READONLY mode, HTML tags passed into Markdown directly, so you can use HTML tags as ../html.inc.php. Both $edit_auth and PKWK_READONLY can be configured on pukiwiki.ini.php.

Related

• PHP Markdown
• Markdown
• ../html.inc.php の拡張と考えられないこともない。

How to use

I assume you are enabling multiline plugin arguments as Pukiwiki Plus.

#markdown{{
ページ全体をこのように囲めば・・・
If whole page was enclosed like this....

*   Red
*   Green
*   Blue
}}

ページ全体をこのように囲めば・・・ If whole page was enclosed like this....

• Red
• Green
• Blue

Please refer official Markdown site about syntax.

Download

First, please download PHP Markdown and place the file at your plugin directory.

プラグインで複数行引数を使えるようにしておきます*1。pukiwiki.ini.php

-define('PKWKEXP_DISABLE_MULTILINE_PLUGIN_HACK', 1); // 1 = Disabled
+define('PKWKEXP_DISABLE_MULTILINE_PLUGIN_HACK', 0); // 1 = Disabled

Save from right-click, and put into plugin directory.

markdown.inc.php

What's new viewcvs

Compatibility Check

Please join us to check compatibilities.

Compatible

Incompatible