Skip to content

Commit 6b20a1e

Browse files
committed
Update manual date and man pages.
1 parent 48badd2 commit 6b20a1e

File tree

2 files changed

+40
-12
lines changed

2 files changed

+40
-12
lines changed

MANUAL.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Pandoc User's Guide
33
author: John MacFarlane
4-
date: 2025-10-20
4+
date: 2025-12-01
55
---
66

77
# Synopsis

pandoc-cli/man/pandoc.1

Lines changed: 39 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
.\" Automatically generated by Pandoc 3.8.2.1
22
.\"
3-
.TH "pandoc" "1" "2025\-10\-20" "pandoc 3.8.2.1" "Pandoc User\[cq]s Guide"
3+
.TH "pandoc" "1" "2025\-12\-01" "pandoc 3.8.2.1" "Pandoc User\[cq]s Guide"
44
.SH NAME
55
pandoc - general markup converter
66
.SH SYNOPSIS
@@ -43,7 +43,8 @@ Markdown can be expected to be lossy.
4343
If no \f[I]input\-files\f[R] are specified, input is read from
4444
\f[I]stdin\f[R].
4545
Output goes to \f[I]stdout\f[R] by default.
46-
For output to a file, use the \f[CR]\-o\f[R] option:
46+
For output to a file, use the \f[CR]\-o\f[R]/\f[CR]\-\-output\f[R]
47+
option:
4748
.IP
4849
.EX
4950
pandoc \-o output.html input.txt
@@ -205,6 +206,8 @@ Specify input format.
205206
\f[I]FORMAT\f[R] can be:
206207
.RS
207208
.IP \(bu 2
209+
\f[CR]asciidoc\f[R] (AsciiDoc markup)
210+
.IP \(bu 2
208211
\f[CR]bibtex\f[R] (BibTeX bibliography)
209212
.IP \(bu 2
210213
\f[CR]biblatex\f[R] (BibLaTeX bibliography)
@@ -281,6 +284,8 @@ if you need extensions not supported in \f[CR]gfm\f[R].
281284
.IP \(bu 2
282285
\f[CR]pod\f[R] (Perl\(cqs Plain Old Documentation)
283286
.IP \(bu 2
287+
\f[CR]pptx\f[R] (PowerPoint)
288+
.IP \(bu 2
284289
\f[CR]ris\f[R] (RIS bibliography)
285290
.IP \(bu 2
286291
\f[CR]rtf\f[R] (Rich Text Format)
@@ -299,6 +304,8 @@ if you need extensions not supported in \f[CR]gfm\f[R].
299304
.IP \(bu 2
300305
\f[CR]vimwiki\f[R] (Vimwiki)
301306
.IP \(bu 2
307+
\f[CR]xlsx\f[R] (Excel spreadsheet)
308+
.IP \(bu 2
302309
\f[CR]xml\f[R] (XML version of native AST)
303310
.IP \(bu 2
304311
the path of a custom Lua reader, see Custom readers and writers below
@@ -324,6 +331,18 @@ Specify output format.
324331
.IP \(bu 2
325332
\f[CR]asciidoctor\f[R] (deprecated synonym for \f[CR]asciidoc\f[R])
326333
.IP \(bu 2
334+
\f[CR]bbcode\f[R] BBCode
335+
.IP \(bu 2
336+
\f[CR]bbcode_fluxbb\f[R] BBCode (FluxBB)
337+
.IP \(bu 2
338+
\f[CR]bbcode_phpbb\f[R] BBCode (phpBB)
339+
.IP \(bu 2
340+
\f[CR]bbcode_steam\f[R] BBCode (Hubzilla)
341+
.IP \(bu 2
342+
\f[CR]bbcode_hubzilla\f[R] BBCode (Hubzilla)
343+
.IP \(bu 2
344+
\f[CR]bbcode_xenforo\f[R] BBCode (xenForo)
345+
.IP \(bu 2
327346
\f[CR]beamer\f[R] (LaTeX beamer slide show)
328347
.IP \(bu 2
329348
\f[CR]bibtex\f[R] (BibTeX bibliography)
@@ -5826,34 +5845,43 @@ The link text will be used as the image\(cqs alt text:
58265845
.SS Extension: \f[CR]implicit_figures\f[R]
58275846
An image with nonempty alt text, occurring by itself in a paragraph,
58285847
will be rendered as a figure with a caption.
5829-
The image\(cqs alt text will be used as the caption.
5848+
The image\(cqs description will be used as the caption.
58305849
.IP
58315850
.EX
5832-
![This is the caption](/url/of/image.png)
5851+
![This is the caption.](image.png)
58335852
.EE
58345853
.PP
58355854
How this is rendered depends on the output format.
58365855
Some output formats (e.g.\ RTF) do not yet support figures.
58375856
In those formats, you\(cqll just get an image in a paragraph by itself,
58385857
with no caption.
5839-
For LaTeX output, you can specify a figure\(cqs positioning by adding
5840-
the \f[CR]latex\-placement\f[R] attribute.
5841-
.IP
5842-
.EX
5843-
![This is the caption](/url/of/image.png){latex\-placement=\(dqht\(dq}
5844-
.EE
58455858
.PP
58465859
If you just want a regular inline image, just make sure it is not the
58475860
only thing in the paragraph.
58485861
One way to do this is to insert a nonbreaking space after the image:
58495862
.IP
58505863
.EX
5851-
![This image won\(aqt be a figure](/url/of/image.png)\(rs
5864+
![This image won\(aqt be a figure](image.png)\(rs
58525865
.EE
58535866
.PP
58545867
Note that in reveal.js slide shows, an image in a paragraph by itself
58555868
that has the \f[CR]r\-stretch\f[R] class will fill the screen, and the
58565869
caption and figure tags will be omitted.
5870+
.PP
5871+
To specify an alt text for the image that is different from the caption,
5872+
you can use an explicit attribute (assuming the
5873+
\f[CR]link_attributes\f[R] extension is set):
5874+
.IP
5875+
.EX
5876+
![The caption.](image.png){alt=\(dqdescription of image\(dq}
5877+
.EE
5878+
.PP
5879+
For LaTeX output, you can specify a figure\(cqs positioning by adding
5880+
the \f[CR]latex\-placement\f[R] attribute.
5881+
.IP
5882+
.EX
5883+
![The caption.](image.png){latex\-placement=\(dqht\(dq}
5884+
.EE
58575885
.SS Extension: \f[CR]link_attributes\f[R]
58585886
Attributes can be set on links and images:
58595887
.IP

0 commit comments

Comments
 (0)