NAME

pod2pandoc - convert Pod to Pandoc document model

SYNOPSIS

  pod2pandoc [OPTIONS] [INPUT...] | pandoc -f json ...

DESCRIPTION

pod2pandoc converts POD format documentation (perlpod) to the abstract document model used by Pandoc for further processing to other document formats (HTML, Markdown, LaTeX, PDF, EPUB, docx, ODT, man, ICML...). By default or with input - a document is read from STDIN. Multiple input files are combined to one document.

Conversion is based on Pod::Simple::Pandoc which uses Pandoc::Element.

Examples

  pod2pandoc Module.pm | pandoc -f json -o Module.pdf
  pod2pandoc Module.pm | pandoc -f json -o Module.html

Or even shorter (not implemented yet):

  pod2pandoc Module.pm -- -o Module.pdf

With processing:

  pod2pandoc --filter 'Header => Para [ Strong [ Str $_->string ] ]' Module.pm

OPTIONS

--filter 'SELECTOR => ACTION'

Preprocess the document. See Pandoc::Filter::Lazy for filter syntax.

--help|-h|-?

Print out usage information and exit

--man

Print the full manual page and exit

SEE ALSO

This script together with Pandoc can be used as customizable replacement for specialized Pod converter scripts such as pod2html, pod2man, pod2readme, pod2usage, pod2latex, pod2markdown, and pod2text.