Debian Codegraph @

bin/markdent-html

raw
1 #!/usr/bin/perl
2
3 use strict;
4 use warnings;
5
6 our $VERSION = '0.40';
7
8 use Markdent::CLI;
9
10 Markdent::CLI->new_with_options()->run();
11
12 # PODNAME: markdent-html
13
14 # ABSTRACT: Turn Markdown into HTML with Markdent
15
16 __END__
17
18 =pod
19
20 =encoding UTF-8
21
22 =head1 NAME
23
24 markdent-html - Turn Markdown into HTML with Markdent
25
26 =head1 VERSION
27
28 version 0.40
29
30 =head1 SYNOPSIS
31
32 $> markdent-html --file ./path/to/text.md
33
34 =head1 DESCRIPTION
35
36 This tool turns Markdown into HTML using L<Markdent>.
37
38 =head1 OPTIONS
39
40 This tool accepts the following command line options:
41
42 =head2 --file
43
44 The file containing the Markdown to process. You must provide this or
45 C<--text>, but not both.
46
47 Pass C<-> to read from C<STDIN>.
48
49 =head2 --text
50
51 The Markdown text to process. You must provide this or C<--file>, but not
52 both.
53
54 =head2 --title
55
56 If you pass then the output will be a full HTML document containing this as
57 the C<< <title> >> tag. If this isn't passed then the output will be a HTML
58 fragment with no C<< <html> >> or C<< <body> >> tags.
59
60 =head2 --charset
61
62 If you pass with a C<--title> it will be used to populate a C<< <meta
63 charset="..."> >> tag for the document.
64
65 =head2 --language
66
67 If you pass with a C<--title> it will be used to set the C<lang> attribute for
68 the document's C<< <html> >> tag.
69
70 =head2 --dialects
71
72 You can add one or more dialects to the standard parser with this option. This
73 can either be a full class name like C<Markdent::Dialect::GitHub> or just a
74 short name like C<GitHub>.
75
76 =head1 SUPPORT
77
78 Bugs may be submitted at L<https://github.com/houseabsolute/Markdent/issues>.
79
80 I am also usually active on IRC as 'autarch' on C<irc://irc.perl.org>.
81
82 =head1 SOURCE
83
84 The source code repository for Markdent can be found at L<https://github.com/houseabsolute/Markdent>.
85
86 =head1 AUTHOR
87
88 Dave Rolsky <[email protected]>
89
90 =head1 COPYRIGHT AND LICENSE
91
92 This software is copyright (c) 2021 by Dave Rolsky.
93
94 This is free software; you can redistribute it and/or modify it under
95 the same terms as the Perl 5 programming language system itself.
96
97 The full text of the license can be found in the
98 F<LICENSE> file included with this distribution.
99
100 =cut