NAME

pandoc-filter - execute Pandoc filters listed on metadata field filters

DESCRIPTION

This Pandoc filter executes other filters listed in document metadata field filters. Each filter must be an executable files or have known file extension and either be given by absolute or relative path or given by name in ~/.pandoc/filters or $PATH.

SYNOPSIS

pandoc --filter pandoc-filters -o output.html < input.md

In input.md:

---
filters:
  - filter1        # in $PATH or ~/.pandoc/filters
  - ./filter2.pl   # relative path
  - /path/filter3  # absolute path
...

OPTIONS

--help|-h

Print this help.

--to|--write|-t|-w <format>

Print help in given Pandoc output format, e.g. markdown.

--about

Print purpose of this script in one line.

--list|-l

List all filters in ~/.pandoc/filters, optionally with purpose (for those supporting option --about.