From 5387ebd8db3b8cf98befd75d9aa42716acaf8dec Mon Sep 17 00:00:00 2001 From: fiddlosopher Date: Tue, 2 Jan 2007 02:58:54 +0000 Subject: Added 'hsmarkdown' wrapper, designed to be used as a drop-in replacement for Markdown.pl. It calls pandoc with the options '--from markdown --to html --strict' and disallows other options. (Any command-line options will be interpreted as arguments.) git-svn-id: https://pandoc.googlecode.com/svn/trunk@399 788f1e2b-df1e-0410-8736-df70ead52e1b --- man/man1/hsmarkdown.1 | 36 ++++++++++++++++++++++++++++++++++++ man/man1/pandoc.1 | 2 +- 2 files changed, 37 insertions(+), 1 deletion(-) create mode 100644 man/man1/hsmarkdown.1 (limited to 'man') diff --git a/man/man1/hsmarkdown.1 b/man/man1/hsmarkdown.1 new file mode 100644 index 000000000..3db8a8b45 --- /dev/null +++ b/man/man1/hsmarkdown.1 @@ -0,0 +1,36 @@ +.TH HSMARKDOWN 1 "January 1, 2007" Pandoc "User Manuals" +.SH NAME +hsmarkdown \- convert markdown-formatted text to HTML +.SH SYNOPSIS +\fBhsmarkdown\fR [\fIinput\-file\fR]... +.SH DESCRIPTION +\fBhsmarkdown\fR converts markdown-formatted text to HTML. It is designed +to be usable as a drop-in replacement for John Gruber's \fBMarkdown.pl\fR. +.PP +If no \fIinput\-file\fR is specified, input is read from STDIN. +Otherwise, the \fIinput\-files\fR are concatenated (with a blank +line between each) and used as input. Output goes to STDOUT by +default. For output to a file, use shell redirection: +.IP +.B hsmarkdown input.txt > output.html +.PP +\fBhsmarkdown\fR uses the UTF\-8 character encoding for both input and output. +If your local character encoding is not UTF\-8, you should pipe input +and output through \fBiconv\fR: +.IP +.B iconv \-t utf\-8 input.txt | hsmarkdown | iconv \-f utf\-8 +.PP +\fBhsmarkdown\fR is implemented as a wrapper around \fBpandoc\fR(1). It +calls \fBpandoc\fR with the options \fB\-\-from markdown \-\-to html +\-\-strict\fR and disables all other options. (Command-line options +will be interpreted as filenames, as they are by \fBMarkdown.pl\fR.) +.SH "SEE ALSO" +\fBpandoc\fR(1). +The +.I README +file distributed with Pandoc contains full documentation. + +The Pandoc source code and all documentation may be downloaded from +. +.SH AUTHOR +John MacFarlane diff --git a/man/man1/pandoc.1 b/man/man1/pandoc.1 index a1df84208..4123cd5d9 100644 --- a/man/man1/pandoc.1 +++ b/man/man1/pandoc.1 @@ -4,7 +4,7 @@ pandoc \- general markup converter .SH SYNOPSIS \fBpandoc\fR [\fIoptions\fR] [\fIinput\-file\fR]... .SH DESCRIPTION -\fBPandoc\fR converts files from one markup format to another. It can +\fIPandoc\fR converts files from one markup format to another. It can read markdown and (subsets of) reStructuredText, HTML, and LaTeX, and it can write markdown, reStructuredText, HTML, LaTeX, RTF, DocBook XML, and S5 HTML slide shows. -- cgit v1.2.3