Skip to content
A pandoc filter for numbering all kinds of things.
Branch: develop
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.


Build Status Coveralls Scrutinizer PyPI version PyPI format License Python version Downloads Source Rank Development Status Docs Code style: black

license icon by Daniel Bruce, format icon by Picol, status icon by Just Icon, code style icon by Google Material Design icons

pandoc-numbering is a pandoc filter for numbering all kinds of things.


See the Read the docs pages.


To apply the filter, use the following option with pandoc:

--filter pandoc-numbering


pandoc-numbering requires python, a programming language that comes pre-installed on linux and Mac OS X, and which is easily installed on Windows. Either python 2.7 or 3.x will do.

Install pandoc-numbering as root using the bash command

pip install pandoc-numbering

To upgrade to the most recent release, use

pip install --upgrade pandoc-numbering

To upgrade to the current code, use

pip install --upgrade --force --no-cache git+

pip is a script that downloads and installs modules from the Python Package Index, PyPI. It should come installed with your python distribution. If you are running linux, pip may be bundled separately. On a Debian-based system (including Ubuntu), you can install it as root using

apt-get update
apt-get install python-pip

Getting Help

If you have any difficulties with pandoc-numbering, please feel welcome to file an issue on github so that we can help.

You can’t perform that action at this time.