Pandit uses Pandoc to generate HTML files from Markdown, Org-mode, reStructuredText, and AsciiDoc files.

To start using Pandit, include the following files in your repository:

Makefile : Build instructions

css.mk : Stylesheets to include in the HTML

css-x.mk : Stylesheets to copy to the output directory

defaults.yaml : Default options for Pandoc

For each source file, the default options are read from all of these files, if they exist:

• defaults.yaml in the repository root
• defaults.yaml in the current directory
• <basename>.yaml (e.g. example.yaml for example.md)

The generated site can be viewed on the local file system, or served by a web server.

To generate the site to be accessed from the local file system, use:

make

To generate the site to be served by a web server, and transform links to remove the .html extension and the index.html ending, use:

make WEB=1

Pandit strives to be minimalist, it only depends on pandoc, git, and make.

This example sets up a site with the tufte-pandoc-css template and tufte-css stylesheets.

mkdir pub
git submodule add https://github.com/p2pcollab/pandit pub/pandit
git submodule add https://github.com/p2pcollab/tufte-pandoc-css pub/tufte-pandoc-css
git submodule add https://github.com/p2pcollab/tufte-css pub/tufte-css
ln -s pub/pandit/Makefile
cp pub/pandit/config/tufte/* .
make WEB=1

See this repository for the source code and issue tracker.

Licensed under either of Apache License, Version 2.0 or MIT license at your option.