Skip to content
Pandoc filters of the Dual Markdown Framework
Python Shell Batchfile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

This project provides two pandoc filters for the Dual Markdown Framework: dual_md and teaching_md.

The Markdown extensions provided by these filters are described here.


To use any of the two available filters (dual_md and teaching_md) just use the -F option of pandoc:

pandoc -F dual_md -F teaching_md [rest-of-options]


To use these pandoc filters, you must install Pandoc on your system. It is also highly recommended to install pandoc-crossref to benefit from all the Markdown extensions provided by the various filters of the Dual Markdown Framework.

Binary installation (Windows and Mac OS X only)

In the project's download page you can find a ZIP file containing executable files for Windows and Mac OS X. For the installation, just extract the executable files from the ZIP archive and place them in any directory included in the PATH (e.g. the directory where pandoc.exe or the pandoc executable was installed on your system).

Installation from source

Installing the pandoc filters from source requires [Python], a programming language whose interpreter comes pre-installed on Linux and Mac OS X, and which can be easily installed on [Windows]. Panbuild works with both Python v2.7 and v3.x.

The installation also requires pip, a program that downloads and installs modules from the Python Package Index ([PyPI]) or from a specified URL. On Mac OS X, it typically comes installed with your Python distribution. On Windows, make sure you choose to install pip during the installation of Python (latest Python installers provide such an option). On a Debian-based system (including Ubuntu), you can install pip (as root) as follows:

apt-get install python-pip

There are basically two ways to install Panbuild from source: with and without git.

Git-based installation

This approach is straightforward and perhaps more suitable for Linux and Mac OS X, where the git command can be easily installed. In following this approach you can install the filters by using the following command as root:

pip install git+

To upgrade to the most recent release, proceed as follows:

pip install --upgrade git+

Installation without git

If the one-command installation shown above does not work (i.e. git is not installed on your system) you can follow this two-step process:

  1. Download a copy of the repository in ZIP format and extract it in a temporary folder on your computer.

  2. Then install the filters on your system by running pip as follows:

pip install <full_path_of_your_temporary_folder>
You can’t perform that action at this time.