Pandoc Scholar — semantically rich academic articles with Scrivener

For the academics among us, Pandoc Scholar is a manuscript formatting system built on Markdown that uses structured metadata to generate semantically rich final documents for preprint / print / collaboration. Because Pandoc works well with Scrivener’s MMD output, this means you can get nice structured output easily from Scrivener.

Main Page — github.com/pandoc-scholar/pandoc-scholar
Article — doi.org/10.7717/peerj-cs.112

You use metadata to specify author names, affiliations, correspondence, abstract etc. and pandoc-scholar builds the properly formatted output. It manages bibliography using CSL style files, and also allows you to semantically label your citations. I prefer to use Pandocomatic to handle my pandoc conversions from Scrivener, but I am translating my templates to use the pandoc-scholar specifications.

Hi,

Very useful article.
Could you explain how to install Pandoc for Windows users? And Pandomic.

Thank you,

Ana.

Hi Ana,

For Pandoc for windows there is an MSI installer here:

github.com/jgm/pandoc/releases/latest

And if you want to benefit from the PDF output, you need to install LaTeX, and Pandoc recommend MikTeX for Windows users:

miktex.org

With these installed, you should be able to download pandoc-scholar, unzip it and run it without further problems.

I have my own workflow for using Pandoc with Scrivener, which involves using Pandocomatic[1]. This is a simple additional tool which simply adds templates to Pandoc. Pandocomatic takes your scrivener.mmd compile, the template and runs pandoc for you. Pandoc-scholar does something similar but it is more specific for academics. Either will give you IMO better output than you can get from Scrivener alone. I detail some of the advantages here:

github.com/iandol/scrivomatic

[1] To install pandocomatic, because Windows doesn’t come with Ruby, you need to install it first: rubyinstaller.org is the recommended route for Windows users. Then when it is installed, you install pandocomatic using the gem command.