Jump to content

Pandoc

From Wikipedia, the free encyclopedia
Pandoc
Original author(s)John MacFarlane
Initial release10 August 2006 (18 years ago) (2006-08-10)
Stable release
3.5[1] Edit this on Wikidata / 5 October 2024 (48 days ago) (5 October 2024)
Repository
Written inHaskell
Operating systemUnix-like, Windows
PlatformCross-platform
LicenseGNU GPLv2-or-later
Websitepandoc.org

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]

Functionality

[edit]

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

[edit]

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

[edit]

Input formats

[edit]

The input format with the most support is an extended version of Markdown.[10] Notwithstanding, pandoc can also read in the following formats:

Output formats

[edit]

Pandoc can create files in the following output formats, which are not necessarily the same set of formats as the input formats:

See also

[edit]

References

[edit]
  1. ^ "Release 3.5". 5 October 2024. Retrieved 23 October 2024.
  2. ^ 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.
  3. ^ 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.[permanent dead link]
    - 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.
  4. ^ "John MacFarlane". Department of Philosophy. University of California, Berkeley. Retrieved 25 July 2014.
  5. ^ "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...
  6. ^ Fenner, Martin (12 December 2013). "From Markdown to JATS XML in one Step". Gobbledygook. doi:10.53731/r294649-6f79289-8cw0k. Retrieved 27 June 2014.
  7. ^ a b "Citations". Pandoc User's Guide. Retrieved 2021-04-08.
  8. ^ 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.
  9. ^ Denlinger, Kyle. "Research Guides: Zotero: Citations & Bibliographies". guides.zsr.wfu.edu. Retrieved 2023-06-21.
  10. ^ "Pandoc's Markdown". Pandoc User's Guide. Retrieved 2019-08-01.
  11. ^ Mullen, Lincoln (20 March 2012). "Make Your Own E-Books with Pandoc". The Chronicle of Higher Education Blogs: ProfHacker. Retrieved 27 June 2014.
  12. ^ "Getting started with pandoc". pandoc.org. Creating a PDF. Retrieved 22 January 2019.
  13. ^ 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.
[edit]