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
55pandoc - general markup converter
66.SH SYNOPSIS
@@ -43,7 +43,8 @@ Markdown can be expected to be lossy.
4343If no \f[I] input \- files \f[ R ] are specified, input is read from
4444\f[I] stdin \f[ R ] .
4545Output 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
4950pandoc \- 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\(cq s 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
304311the 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 ]
58275846An image with nonempty alt text, occurring by itself in a paragraph,
58285847will be rendered as a figure with a caption.
5829- The image\(cq s alt text will be used as the caption.
5848+ The image\(cq s description will be used as the caption.
58305849.IP
58315850.EX
5832- 
5851+ 
58335852 .EE
58345853.PP
58355854How this is rendered depends on the output format.
58365855Some output formats (e.g.\ RTF) do not yet support figures.
58375856In those formats, you\(cq ll just get an image in a paragraph by itself,
58385857with no caption.
5839- For LaTeX output, you can specify a figure\(cq s positioning by adding
5840- the \f[CR] latex \- placement \f[ R ] attribute.
5841- .IP
5842- .EX
5843- {latex\- placement=\(dq ht\(dq }
5844- .EE
58455858.PP
58465859If you just want a regular inline image, just make sure it is not the
58475860only thing in the paragraph.
58485861One way to do this is to insert a nonbreaking space after the image:
58495862.IP
58505863.EX
5851- \(rs
5864+ \(rs
58525865 .EE
58535866.PP
58545867Note that in reveal.js slide shows, an image in a paragraph by itself
58555868that has the \f[CR] r \- stretch \f[ R ] class will fill the screen, and the
58565869caption 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+ {alt=\(dq description of image\(dq }
5877+ .EE
5878+ .PP
5879+ For LaTeX output, you can specify a figure\(cq s positioning by adding
5880+ the \f[CR] latex \- placement \f[ R ] attribute.
5881+ .IP
5882+ .EX
5883+ {latex\- placement=\(dq ht\(dq }
5884+ .EE
58575885.SS Extension: \f[CR] link_attributes \f[ R ]
58585886Attributes can be set on links and images:
58595887.IP
0 commit comments