Description

The Markdown plugin uses the Markdown text-to-HTML conversion tool to allow you to use its syntax for writing blog entries. The Markdown plugin calls out to the Markdown tool using Perl, so you will also need to be able to run Perl on your blog server.

Installation and Setup

In your global /WEB-INF/plugin.properties file, add the following line:

markdown=org.blojsom.plugin.markdown.MarkdownPlugin

You may then add "markdown" to one of the flavor-based plugin chains. These plugin chains can be found in the individual user's plugin.properties file. For example:

html.blojsom-plugin-chain=..., markdown

You will need to download the Markdown tool and have installed it on your server.

In your individual blog.properties file, be sure to add .*markdown to the blog-file-extensions parameter value. The Markdown plugin uses .markdown to identify blog entries that should be passed through the plugin for processing, so be sure your entries end with this extension if you want this plugin to work correctly.

The Markdown plugin can also be run on entries not ending in a .markdown extension by using the metadata plugin before the Markdown plugin in one of the flavor-based plugin chains. The metadata key for the Markdown plugin would be specified as meta-run-markdown=y on a separate line in your blog entry text.

The Markdown plugin requires the execution string be defined in /WEB-INF/web.xml. For example:

<init-param>
    <param-name>plugin-markdown-execution</param-name>
    <param-value>/usr/bin/perl/software/Markdown_1.0b3/Markdown.pl</param-value>
</init-param>