/pandoc-latex-levelup

A pandoc filter to shift the level of all headers in a latex/pdf output

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

pandoc-latex-levelup

Build Status Docker Automated Build

A pandoc filter to shift the level of all headers in a latex/pdf output

The filter is written in Python with panflute which I recommend if you want to create your own pandoc filters.

Install

sudo pip install pandoc-latex-levelup

or

docker run -d daamien/pandoc-latex-levelup

Quick Start

pandoc --filter pandoc-latex-levelup ./pandoc_latex_levelup.sample.md \ 
       --toc -N -o ./pandoc_latex_levelup.sample.pdf

Configuration

The filter is designed to work without any parameter, but you can use the two options below:

levelup: {                                                                      
  enable: True,                                                                 
  unnumbered_h1: False,                                                         
}

  • enable is a killswitch. Set it to False and the filter will be disabled. This is useful when you use the filter in a script and you want ot toggle it off for certain md files (default: True)

  • unnumbered_h1 remove numbering from level1 headers (default: True)

Example

See pandoc-latex-levelup.sample.md

and pandoc-latex-levelup.sample.pdf

Contributing & Getting Help

If you have any difficulties with this software, please file an issue here :

https://github.com/daamien/pandoc-latex-levelup/issues

License

This software is available under the BSD 3-Clause Licence.

see LICENSE