Pandoc
Pandoc is a free-software document converter, widely used as a writing tool (especially by scholars)[2] and as a basis for publishing workflows.[3] It was created by John MacFarlane, a philosophy professor at the University of California, Berkeley.[4]
Original author(s) | John MacFarlane |
---|---|
Initial release | 10 August 2006 |
Stable release | 3.1.8[1]
/ 9 September 2023 |
Repository | |
Written in | Haskell |
Operating system | Unix-like, Windows |
Platform | Cross-platform |
License | GNU GPLv2 |
Website | pandoc |
Functionality
Pandoc dubs itself a "markup format" converter. It can take a document in one of the supported formats and convert only its markup to another format. Maintaining the look and feel of the document is not a priority.[5]
Plug-ins for custom formats can also be written in Lua, which has been used to create an exporting tool for the Journal Article Tag Suite, for example.[6]
CiteProc
An included CiteProc option allows pandoc to use bibliographic data from reference management software in any of five formats: BibTeX, BibLaTeX, CSL JSON or CSL YAML, or RIS.[7] The information is automatically transformed into a citation in various styles (such as APA, Chicago, or MLA) using an implementation of the Citation Style Language.[7] This allows the program to serve as a simpler alternative to LaTeX for producing academic writing in Markdown with inline citation keys.[8] Or the program can be used to convert any bibliographic data stream in the accepted formats into a list of citations in a chosen style.[9]
Supported file formats
Input formats
The input format with the most support is an extended version of Markdown.[10] Notwithstanding, pandoc can also read in the following formats:
- Creole
- DocBook
- EPUB
- FictionBook (FB2)
- Haddock
- HTML
- Jira wiki markup
- Journal Article Tag Suite (JATS)
- JSON
- LaTeX
- Lightweight markup language
- man
- Markdown: Strict, CommonMark, GitHub Flavored Markdown (GFM), MultiMarkdown (MMD) and Markdown Extra (PHP Extra) variants
- OpenDocument (ODT)
- OPML
- Office Open XML: Microsoft Word variant
- Org-mode
- reStructuredText
- Textile
- txt2tags (t2t)
- Wiki markup: MediaWiki, Muse, TikiWiki, TWiki and Vimwiki variants
Output formats
Pandoc can create files in the following output formats, which are not necessarily the same set of formats as the input formats:
- AsciiDoc
- ConTeXt
- DocBook: Versions 4 and 5
- EPUB: Versions 2 and 3[11]
- FictionBook (FB2)
- Haddock
- HTML: HTML4 and HTML5 variants, respectively compliant with XHTML 1.0 Transitional and XHTML Strict
- InDesign ICML
- Jira wiki markup
- Journal Article Tag Suite (JATS)
- JSON
- LaTeX
- man
- Markdown: Strict, CommonMark, GitHub Flavored Markdown (GFM), MultiMarkdown (MMD) and Markdown Extra (PHP Extra) variants
- OpenDocument (ODT/ODF)
- OPML
- Office Open XML: Microsoft Word and Microsoft PowerPoint variants
- Org-mode
- PDF (needs a third-party add-on like ConTeXt,
pdfroff
,wkhtmltopdf
,weasyprint
orprince
)[12] - Plain text
- reStructuredText
- Rich Text Format (RTF)
- TEI
- Texinfo
- Textile
- Web-based slideshows: LaTeX Beamer, Slideous, Slidy, DZSlides, reveal.js and S5 variants[13]
- Wiki markup: DokuWiki, MediaWiki, Muse, TikiWiki, TWiki and Vimwiki variants
References
- "Release 3.1.8". 9 September 2023. Retrieved 18 September 2023.
- Mullen, Lincoln (23 February 2012). "Pandoc Converts All Your (Text) Documents". The Chronicle of Higher Education Blogs: ProfHacker. Retrieved 27 June 2014.
- McDaniel, W. Caleb (28 September 2012). "Why (and How) I Wrote My Academic Book in Plain Text". W. Caleb McDaniel at Rice University. Retrieved 27 June 2014.
- Healy, Kieran (23 January 2014). "Plain Text, Papers, Pandoc". Retrieved 27 June 2014.
- Ovadia, Steven (2014). "Markdown for Librarians and Academics". Behavioral & Social Sciences Librarian. 33 (2): 120–124. doi:10.1080/01639269.2014.904696. ISSN 0163-9269. S2CID 62762368. - Till, Kaitlyn; Simas, Shed; Larkai, Velma (14 April 2014). "The Flying Narwhal: Small mag workflow". Publishing @ SFU. Retrieved 11 March 2018.
- Maxwell, John (1 November 2013). "Building Publishing Workflows with Pandoc and Git". Publishing @ SFU. Retrieved 27 June 2014.
- Maxwell, John (26 February 2014). "On Pandoc". eBound Canada: Digital Production Workshop, Vancouver, BC. Archived from the original on 28 February 2015. Retrieved 27 June 2014.
- Maxwell, John (1 November 2013). "Building Publishing Workflows with Pandoc and Git". Publishing @ SFU. Retrieved 12 April 2019.
- Krewinkel, Albert; Robert Winkler (8 May 2017). "Formatting Open Science: agilely creating multiple document formats for academic manuscripts with Pandoc Scholar". PeerJ Computer Science. 3: e112. doi:10.7717/peerj-cs.112. Retrieved 25 May 2017. - "John MacFarlane". Department of Philosophy. University of California, Berkeley. Retrieved 25 July 2014.
- "Pandoc User's Guide". pandoc.org. Description. Retrieved 22 January 2019.
...one should not expect perfect conversions between every format and every other. Pandoc attempts to preserve the structural elements of a document, but not formatting details...
- Fenner, Martin (12 December 2013). "From Markdown to JATS XML in one Step". Gobbledygook. doi:10.53731/r294649-6f79289-8cw0k. Retrieved 27 June 2014.
- "Citations". Pandoc User's Guide. Retrieved 2021-04-08.
- Tenen, Dennis; Grant Wythoff (19 March 2014). "Sustainable Authorship in Plain Text using Pandoc and Markdown". The Programming Historian (3). doi:10.46430/phen0041. Retrieved 27 June 2014.
- Denlinger, Kyle. "Research Guides: Zotero: Citations & Bibliographies". guides.zsr.wfu.edu. Retrieved 2023-06-21.
- "Pandoc's Markdown". Pandoc User's Guide. Retrieved 2019-08-01.
- Mullen, Lincoln (20 March 2012). "Make Your Own E-Books with Pandoc". The Chronicle of Higher Education Blogs: ProfHacker. Retrieved 27 June 2014.
- "Getting started with pandoc". pandoc.org. Creating a PDF. Retrieved 22 January 2019.
- See as an example MacFarlane, John (17 May 2014). "Pandoc for Haskell Hackers". BayHac 2014, Mountain View, CA. Retrieved 27 June 2014.
{{cite web}}
: CS1 maint: location (link) The source file is written in Markdown.