README

Pandoc









 The universal markup converter

Pandoc is a Haskell library for converting from
one markup format to another, and a command-line tool that uses this
library.

It can convert from



- asciidoc (AsciiDoc markup)
- bibtex (BibTeX bibliography)
- biblatex (BibLaTeX bibliography)
- bits (BITS XML, alias
  for jats)
- commonmark (CommonMark Markdown)
- commonmark_x (CommonMark Markdown with
  extensions)
- creole (Creole 1.0)
- csljson (CSL
  JSON
  bibliography)
- csv (CSV table)
- tsv
  (TSV
  table)
- djot (Djot markup)
- docbook (DocBook)
- docx (Word docx)
- dokuwiki (DokuWiki markup)
- endnotexml (EndNote XML
  bibliography)
- epub (EPUB)
- fb2
  (FictionBook2
  e-book)
- fodt (flat OpenDocument text
  document)
- gfm (GitHub-Flavored
  Markdown),
  or the deprecated and less accurate markdown_github; use
  markdown_github
  only if you need extensions not supported in
  gfm.
- haddock (Haddock
  markup)
- html (HTML)
- ipynb (Jupyter
  notebook)
- jats (JATS XML)
- jira
  (Jira/Confluence
  wiki markup)
- json (JSON version of native AST)
- latex (LaTeX)
- markdown (Pandoc’s
  Markdown)
- markdown_mmd
  (MultiMarkdown)
- markdown_phpextra (PHP Markdown
  Extra)
- markdown_strict (original unextended
  Markdown)
- mediawiki (MediaWiki
  markup)
- man (roff man))
- mdoc (mdoc manual page
  markup)
- muse (Muse)
- native (native Haskell)
- odt (OpenDocument text
  document)
- opml (OPML)
- org (Emacs Org mode)
- pod (Perl’s Plain Old
  Documentation)
- pptx
  (PowerPoint)
- ris (RIS)
  bibliography)
- rtf (Rich Text
  Format)
- rst
  (reStructuredText)
- t2t (txt2tags)
- textile (Textile)
- tikiwiki (TikiWiki
  markup)
- twiki (TWiki
  markup)
- typst (typst)
- vimwiki (Vimwiki)
- xlsx (Excel
  spreadsheet)
- xml (XML version of native AST)
- the path of a custom Lua reader, see Custom readers and
  writers
  below



It can convert to



- ansi (text with ANSI escape
  codes, for terminal
  viewing)
- asciidoc (modern AsciiDoc as interpreted by
  Asciidoctor)
- asciidoc_legacy (AsciiDoc as interpreted by
  asciidoc-py).
- asciidoctor (deprecated synonym for asciidoc)
- bbcode BBCode
- bbcode_fluxbb BBCode
  (FluxBB)
- bbcode_phpbb BBCode
  (phpBB)
- bbcode_steam BBCode
  (Steam)
- bbcode_hubzilla BBCode
  (Hubzilla)
- bbcode_xenforo BBCode
  (xenForo)
- beamer (LaTeX beamer slide show)
- bibtex (BibTeX bibliography)
- biblatex (BibLaTeX bibliography)
- chunkedhtml (zip archive of multiple linked HTML files)
- commonmark (CommonMark Markdown)
- commonmark_x (CommonMark Markdown with
  extensions)
- context (ConTeXt)
- csljson (CSL
  JSON
  bibliography)
- djot (Djot markup)
- docbook or docbook4 (DocBook 4)
- docbook5 (DocBook 5)
- docx (Word docx)
- dokuwiki (DokuWiki markup)
- epub or epub3 (EPUB v3 book)
- epub2 (EPUB v2)
- fb2
  (FictionBook2
  e-book)
- fodt (flat OpenDocument text
  document)
- gfm (GitHub-Flavored
  Markdown),
  or the deprecated and less accurate markdown_github; use
  markdown_github
  only if you need ex

Top issues

Discussions

Latest release

I'm pleased to announce the release of pandoc 3.13,
available in the usual places:

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.13

Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.13

This release fixes some regressions and makes many minor
improvements.  See the changelog for full details.

Behavior changes:

- Locations of errors in default files are now reported.
- YAML is now parsed with the yamlet library, which implements
  YAML 1.2. As a result, we'll get better error messages, and:

  + yes, no, on, off, y and n ar