index.txt

---
headerimage:
  alt: "Cartoon of a toaster-like machine ingesting paper, bits,
    and a cat and outputing a book"
  title: "Credit: Amy de Buitléir"
  src: pandoc-cartoon.svgz
  width: "60%"
...

If you need to convert files from one markup format into another,
pandoc is your swiss-army knife.  Pandoc can convert between the
following formats:

(← = conversion from; → = conversion to; ↔ = conversion from and to)

:::: twocol

::: col

Lightweight markup formats

:   ↔ [Markdown] (including [CommonMark] and
    [GitHub-flavored Markdown])\
    ↔ [reStructuredText]\
    → [AsciiDoc]\
    ↔ Emacs [Org-Mode]\
    ↔ Emacs [Muse]\
    ↔ [Textile]\
    → [Markua]\
    ← [txt2tags]\
    ↔ [djot]

HTML formats

:   ↔ (X)HTML 4\
    ↔ HTML5\
    → Chunked HTML

Ebooks

:   ↔ [EPUB] version 2 or 3\
    ↔ [FictionBook2]

Documentation formats

:   → [GNU TexInfo]\
    ↔ [Haddock markup]

Roff formats

:   ↔ [roff man]\
    → [roff ms]

TeX formats

:   ↔ [LaTeX]\
    → [ConTeXt]

XML formats

:   ↔ [DocBook] version 4 or 5\
    ↔ [JATS]\
    ← [BITS]\
    → [TEI Simple]\
    → [OpenDocument XML]

Outline formats

:   ↔ [OPML]

Bibliography formats

:   ↔ [BibTeX]\
    ↔ [BibLaTeX]\
    ↔ [CSL JSON]\
    ↔ CSL YAML\
    ← [RIS]\
    ← [EndNote XML]

:::

::: col

Word processor formats

:   ↔ Microsoft Word [docx]\
    ↔ Rich Text Format [RTF]\
    ↔ OpenOffice/LibreOffice [ODT]

Interactive notebook formats

:   ↔ Jupyter notebook ([ipynb])

Page layout formats

:   → [InDesign ICML]\
    ↔ [Typst]

Wiki markup formats

:   ↔ [MediaWiki markup]\
    ↔ [DokuWiki markup]\
    ← [TikiWiki markup]\
    ← [TWiki markup]\
    ← [Vimwiki markup]\
    → [XWiki markup]\
    → [ZimWiki markup]\
    ↔ [Jira wiki markup]\
    ← [Creole]

Slide show formats

:   → [LaTeX Beamer]\
    → Microsoft [PowerPoint]\
    → [Slidy]\
    → [reveal.js]\
    → [Slideous]\
    → [S5]\
    → [DZSlides]

Data formats

:   ← [CSV] tables\
    ← [TSV] tables

Terminal output

:   → [ANSI]-formatted text

Custom formats

:   ↔ [custom readers] and [writers][custom writers]
    can be written in [Lua]

PDF

:   → via `pdflatex`, `lualatex`, `xelatex`,
    `latexmk`, `tectonic`, `wkhtmltopdf`, `weasyprint`,
    `prince`, `pagedjs-cli`, `context`, or `pdfroff`.
:::

::::

Pandoc understands a number of useful markdown syntax extensions,
including document metadata (title, author, date); footnotes; tables;
definition lists; superscript and subscript; strikeout; enhanced ordered
lists (start number and numbering style are significant); running
example lists; delimited code blocks with syntax highlighting; smart
quotes, dashes, and ellipses; markdown inside HTML blocks; and inline
LaTeX. If strict markdown compatibility is desired, all of these
extensions can be turned off.

LaTeX math (and even macros) can be used in markdown documents.  Several
different methods of rendering math in HTML are provided, including
MathJax and translation to MathML. LaTeX math is converted (as needed
by the output format) to unicode, native Word equation objects,
MathML, or roff eqn.

Pandoc includes a powerful system for automatic citations and
bibliographies.  This means that you can write a citation like

    [see @doe99, pp. 33-35; also @smith04, ch. 1]

and pandoc will convert it into a properly formatted citation using
any of hundreds of [CSL] styles (including footnote styles, numerical
styles, and author-date styles), and add a properly formatted
bibliography at the end of the document.  The bibliographic data
may be in [BibTeX], [BibLaTeX], [CSL JSON], or CSL YAML format.
Citations work in every output format.

There are many ways to customize pandoc to fit your needs,
including a template system and a powerful system for writing
filters.

Pandoc includes a Haskell library and a standalone command-line program.
The library includes separate modules for each input and output format,
so adding a new input or output format just requires adding a new
module.

Pandoc is free software, released under the [GPL].
Copyright 2006--2022 [John MacFarlane].

[John MacFarlane]: http://johnmacfarlane.net/
[markdown]: http://daringfireball.net/projects/markdown/
[reStructuredText]: http://docutils.sourceforge.net/docs/ref/rst/introduction.html
[S5]: http://meyerweb.com/eric/tools/s5/
[HTML]:  http://www.w3.org/TR/html40/
[LaTeX]:  http://www.latex-project.org/
[ConTeXt]: http://www.pragma-ade.nl/ 
[RTF]:  http://en.wikipedia.org/wiki/Rich_Text_Format
[PDF]: http://en.wikipedia.org/wiki/Portable_Document_Format
[ODT]: http://en.wikipedia.org/wiki/OpenDocument
[DocBook]: http://www.docbook.org/
[OpenDocument XML]: http://opendocument.xml.org/
[MediaWiki markup]: http://www.mediawiki.org/wiki/Help:Formatting
[roff man]: http://www.gnu.org/software/groff/groff.html
[roff ms]: http://www.gnu.org/software/groff/groff.html
[GNU Texinfo]: http://www.gnu.org/software/texinfo/
[Haskell]:  http://www.haskell.org/
[GHC]:  http://www.haskell.org/ghc/
[GPL]:  http://www.gnu.org/copyleft/gpl.html
[EPUB]: http://en.wikipedia.org/wiki/EPUB
[Slidy]: http://www.w3.org/Talks/Tools/Slidy
[org-mode]: http://orgmode.org
[Textile]: https://textile-lang.com
[citeproc-hs]:  http://hackage.haskell.org/package/citeproc-hs
[pandoc-citeproc]:  http://hackage.haskell.org/package/pandoc-citeproc
[AsciiDoc]:  https://asciidoc.org
[docx]: https://en.wikipedia.org/wiki/Office_Open_XML
[DZSlides]: http://paulrouget.com/dzslides/
[CSL]: http://citationstyles.org/
[Slideous]: http://goessner.net/articles/slideous/
[FictionBook2]: http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1
[Haddock markup]: http://www.haskell.org/haddock/doc/html/ch03s08.html
[Lua]: http://www.lua.org
[reveal.js]: http://lab.hakim.se/reveal-js/
[InDesign ICML]: http://wwwimages.adobe.com/content/dam/acom/en/devnet/indesign/sdk/cs6/idml/idml-specification.pdf
[OPML]: http://dev.opml.org/spec2.html
[DokuWiki markup]: https://www.dokuwiki.org/wiki:syntax
[TWiki markup]: http://twiki.org/cgi-bin/view/TWiki/TextFormattingRules
[TEI Simple]: https://github.com/TEIC/TEI-Simple
[CommonMark]: http://commonmark.org
[JATS]: https://jats.nlm.nih.gov/publishing/
[BITS]: https://jats.nlm.nih.gov/extensions/bits/
[GitHub-flavored Markdown]: https://github.github.com/gfm/
[Muse]: https://www.gnu.org/software/emacs-muse/manual/
[txt2tags]: http://txt2tags.org
[Vimwiki markup]: https://vimwiki.github.io
[Creole]: http://www.wikicreole.org/
[TWiki markup]: http://twiki.org/cgi-bin/view/TWiki/TextFormattingRules
[TikiWiki markup]: https://doc.tiki.org/Wiki-Syntax-Text#The_Markup_Language_Wiki-Syntax
[ZimWiki markup]: http://zim-wiki.org/manual/Help/Wiki_Syntax.html
[XWiki markup]: https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiSyntax/
[PowerPoint]: https://en.wikipedia.org/wiki/Microsoft_PowerPoint
[ipynb]: https://nbformat.readthedocs.io/en/latest/
[LaTeX Beamer]: https://ctan.org/pkg/beamer
[CSV]: https://tools.ietf.org/html/rfc4180
[Jira wiki markup]: https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all
[BibTeX]: http://tug.org/bibtex/
[BibLaTeX]: https://github.com/plk/biblatex
[CSL JSON]: https://citeproc-js.readthedocs.io/en/latest/csl-json/markup.html
[custom readers]: custom-readers.html
[custom writers]: custom-writers.html
[Markua]: https://leanpub.com/markua/read
[RIS]: https://en.wikipedia.org/wiki/RIS_(file_format)
[EndNote XML]: https://support.clarivate.com/Endnote/s/article/EndNote-XML-Document-Type-Definition
[TSV]: https://www.iana.org/assignments/media-types/text/tab-separated-values
[Typst]: https://typst.app
[djot]: https://djot.net
[ANSI]: https://en.wikipedia.org/wiki/ANSI_escape_code