pandoc-include 0.3.1

Panflute filter to allow file includes

Pandoc filter to allow file includes.

The filter script is based on User Guide for Panflute. This repository is to provide a simple way to install and use it.

Installation

Use pip to install:

pip install --user pandoc-include

Usage

Command

To use this filter, add to pandoc command

pandoc input.md --filter pandoc-include -o output.pdf

Syntax

Each include statement has its own line and has the syntax:

!include ./somefolder/somefile

Or

$include ./somefolder/somefile

Each include statement must be in its own paragraph. That is, in its own line and separated by blank lines.

Leading ./ or ../ is necessary to make it work properly.

Recursive include is supported from v0.3.1.

If no extension was given, “.md” is assumed.

Note: The second syntax may lead to wrong highlighting when using a markdown editor. If it happens, use the first syntax.

License

MIT License