title	css	content-class
A dumb markdown website	https://maxcdn.bootstrapcdn.com/bootswatch/3.3.5/cerulean/bootstrap.min.css	well

This is just a little hack I stumbled across to throw together a blindly simple set of nicely formatted HTML pages on a server quickly and easily.

How it works

Apache's mod_ext_filter allows you to pass the content of files on your filesystem through arbitrary binaries - this just sets that up to run the great pandoc utility on markdown files.

Hard requirements

• Pandoc installed to /usr/bin/pandoc

Soft requirements

Required for the install script to work - but it's incredibly simple to set it up manually yourself without these

• I've only tested install.sh on Debian-based systems sofar
• Apache setup with the a2enmod and a2enconf utilities available

Usage

Run install.sh (or read it and apply manually) and then pop the following into your .htaccess or vhost file:

<IfModule mod_ext_filter.c>
    AddOutputFilter pandoc md
</IfModule>

or alternatively, this (if you have no non-markdown files and don't want file-extensions):

<IfModule mod_ext_filter.c>
    SetOutputFilter pandoc
</IfModule>

Markdown support

See Pandoc's docs for it's Markdown support.

The template also supports various variables in a YAML block (as seen at the top of this README.md file) - you can get a full overview of the variables supported by reading the pandoc-template.html file.

Other thoughts

There's no caching - running pandoc on every page request is probably a terrible idea.