Pandoc Scholar — semantically rich academic articles with Scrivener

User avatar
nontroppo
Posts: 986
Joined: Mon Mar 05, 2007 5:22 pm
Platform: Mac
Location: Airstrip One

Mon Jun 19, 2017 2:46 am Post

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.

mod.png
mod.png (219.15 KiB) Viewed 1026 times


Main Page — https://github.com/pandoc-scholar/pandoc-scholar
Article — https://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.

An
AnaBGonz
Posts: 3
Joined: Wed Oct 26, 2016 4:48 pm
Platform: Windows

Thu Jun 29, 2017 10:27 pm Post

Hi,

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

Thank you,

Ana.

User avatar
nontroppo
Posts: 986
Joined: Mon Mar 05, 2007 5:22 pm
Platform: Mac
Location: Airstrip One

Fri Jun 30, 2017 1:28 pm Post

Hi Ana,

For Pandoc for windows there is an MSI installer here:

https://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:

https://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:

https://github.com/iandol/scrivomatic

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