pod2github - Man Page
Convert POD text to Github flavored markdown
Version
version 1.000
Synopsis
# parse STDIN, print to STDOUT $ pod2github < POD_File > Markdown_File # parse file, print to STDOUT $ pod2github input.pod # parse file, print to file $ pod2github input.pod output.mkdn # parse STDIN, print to file $ pod2github - output.mkdn
Description
This program uses Pod::Markdown::Github to convert POD into Github Markdown sources.
UTF-8 is the default output encoding if no encoding options are specified (see "Options").
It accepts two optional arguments:
- input pod file (defaults to
STDIN
) - output markdown file (defaults to
STDOUT
)
Options
- --html-encode-chars
A list of characters to encode as HTML entities. Pass a regexp character class, or
1
to mean control chars, high-bit chars, and<&>"'
.See "html_encode_chars" in Pod::Markdown for more information.
- --match-encoding (-m)
Use the same
=encoding
as the input pod for the output file.- --output-encoding (-e)
Specify the encoding for the output file.
- --utf8 (-u)
Alias for
-e UTF-8
.
See Also
This program is pretty much a straight copy of pod2markdown, which is in turn strongly based on pod2mdwn
from Module::Build::IkiWiki.
Author
Stefan G. <minimal@cpan.org>
Credits
This software is based on work by:
- Marcel Gruenauer <marcel@cpan.org>
- Victor Moral <victor@taquiones.net>
- Ryan C. Thompson <rct at thompsonclan d0t org>
- Aristotle Pagaltzis <pagaltzis@gmx.de>
- Randy Stauner <rwstauner@cpan.org>
Copyright and License
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.