aboutsummaryrefslogtreecommitdiff
path: root/pandoc-cli/man/pandoc.1
diff options
context:
space:
mode:
Diffstat (limited to 'pandoc-cli/man/pandoc.1')
-rw-r--r--pandoc-cli/man/pandoc.150
1 files changed, 39 insertions, 11 deletions
diff --git a/pandoc-cli/man/pandoc.1 b/pandoc-cli/man/pandoc.1
index 809f8cfc8..281817c19 100644
--- a/pandoc-cli/man/pandoc.1
+++ b/pandoc-cli/man/pandoc.1
@@ -1,6 +1,6 @@
.\" Automatically generated by Pandoc 3.8.2.1
.\"
-.TH "pandoc" "1" "2025\-10\-20" "pandoc 3.8.2.1" "Pandoc User\[cq]s Guide"
+.TH "pandoc" "1" "2025\-12\-01" "pandoc 3.8.2.1" "Pandoc User\[cq]s Guide"
.SH NAME
pandoc - general markup converter
.SH SYNOPSIS
@@ -43,7 +43,8 @@ Markdown can be expected to be lossy.
If no \f[I]input\-files\f[R] are specified, input is read from
\f[I]stdin\f[R].
Output goes to \f[I]stdout\f[R] by default.
-For output to a file, use the \f[CR]\-o\f[R] option:
+For output to a file, use the \f[CR]\-o\f[R]/\f[CR]\-\-output\f[R]
+option:
.IP
.EX
pandoc \-o output.html input.txt
@@ -205,6 +206,8 @@ Specify input format.
\f[I]FORMAT\f[R] can be:
.RS
.IP \(bu 2
+\f[CR]asciidoc\f[R] (AsciiDoc markup)
+.IP \(bu 2
\f[CR]bibtex\f[R] (BibTeX bibliography)
.IP \(bu 2
\f[CR]biblatex\f[R] (BibLaTeX bibliography)
@@ -281,6 +284,8 @@ if you need extensions not supported in \f[CR]gfm\f[R].
.IP \(bu 2
\f[CR]pod\f[R] (Perl\(cqs Plain Old Documentation)
.IP \(bu 2
+\f[CR]pptx\f[R] (PowerPoint)
+.IP \(bu 2
\f[CR]ris\f[R] (RIS bibliography)
.IP \(bu 2
\f[CR]rtf\f[R] (Rich Text Format)
@@ -299,6 +304,8 @@ if you need extensions not supported in \f[CR]gfm\f[R].
.IP \(bu 2
\f[CR]vimwiki\f[R] (Vimwiki)
.IP \(bu 2
+\f[CR]xlsx\f[R] (Excel spreadsheet)
+.IP \(bu 2
\f[CR]xml\f[R] (XML version of native AST)
.IP \(bu 2
the path of a custom Lua reader, see Custom readers and writers below
@@ -324,6 +331,18 @@ Specify output format.
.IP \(bu 2
\f[CR]asciidoctor\f[R] (deprecated synonym for \f[CR]asciidoc\f[R])
.IP \(bu 2
+\f[CR]bbcode\f[R] BBCode
+.IP \(bu 2
+\f[CR]bbcode_fluxbb\f[R] BBCode (FluxBB)
+.IP \(bu 2
+\f[CR]bbcode_phpbb\f[R] BBCode (phpBB)
+.IP \(bu 2
+\f[CR]bbcode_steam\f[R] BBCode (Hubzilla)
+.IP \(bu 2
+\f[CR]bbcode_hubzilla\f[R] BBCode (Hubzilla)
+.IP \(bu 2
+\f[CR]bbcode_xenforo\f[R] BBCode (xenForo)
+.IP \(bu 2
\f[CR]beamer\f[R] (LaTeX beamer slide show)
.IP \(bu 2
\f[CR]bibtex\f[R] (BibTeX bibliography)
@@ -5826,34 +5845,43 @@ The link text will be used as the image\(cqs alt text:
.SS Extension: \f[CR]implicit_figures\f[R]
An image with nonempty alt text, occurring by itself in a paragraph,
will be rendered as a figure with a caption.
-The image\(cqs alt text will be used as the caption.
+The image\(cqs description will be used as the caption.
.IP
.EX
-![This is the caption](/url/of/image.png)
+![This is the caption.](image.png)
.EE
.PP
How this is rendered depends on the output format.
Some output formats (e.g.\ RTF) do not yet support figures.
In those formats, you\(cqll just get an image in a paragraph by itself,
with no caption.
-For LaTeX output, you can specify a figure\(cqs positioning by adding
-the \f[CR]latex\-placement\f[R] attribute.
-.IP
-.EX
-![This is the caption](/url/of/image.png){latex\-placement=\(dqht\(dq}
-.EE
.PP
If you just want a regular inline image, just make sure it is not the
only thing in the paragraph.
One way to do this is to insert a nonbreaking space after the image:
.IP
.EX
-![This image won\(aqt be a figure](/url/of/image.png)\(rs
+![This image won\(aqt be a figure](image.png)\(rs
.EE
.PP
Note that in reveal.js slide shows, an image in a paragraph by itself
that has the \f[CR]r\-stretch\f[R] class will fill the screen, and the
caption and figure tags will be omitted.
+.PP
+To specify an alt text for the image that is different from the caption,
+you can use an explicit attribute (assuming the
+\f[CR]link_attributes\f[R] extension is set):
+.IP
+.EX
+![The caption.](image.png){alt=\(dqdescription of image\(dq}
+.EE
+.PP
+For LaTeX output, you can specify a figure\(cqs positioning by adding
+the \f[CR]latex\-placement\f[R] attribute.
+.IP
+.EX
+![The caption.](image.png){latex\-placement=\(dqht\(dq}
+.EE
.SS Extension: \f[CR]link_attributes\f[R]
Attributes can be set on links and images:
.IP