# Notes on pandoc

**Requirements:**: pandoc and pandoc-crossref

All of the paper itself is written in article.md using pandoc flavor markdown combined with pandoc-crossref.
References for pandoc compatible markdown can be found at [](https://pandoc.org/MANUAL.html#pandocs-markdown).
Some benefits of markdown are:

- You can use your normal .bib reference file to automatically manage references.
- Pandoc markdown allows for tables using simple styling as observed in article.md. 
- Equations can be written with latex styling
- You can reference figures and equations and have them automatically update!

 This build uses a few lua filters included to get nicer behavior with word. 
 
 **How to build:**:

 md->pdf:

 ```bash
pandoc article.md --pdf-engine=xelatex --lua-filter=./typesetting/scholarly-metadata.lua --lua-filter=./typesetting/author-info-blocks.lua  --filter=pandoc-crossref --citeproc --bibliography=references.bib --csl=typesetting/els.csl  -o article.pdf
 ```

 md->docx:

 ```bash
pandoc article.md --lua-filter="./pandoc_lua_filters/scholarly-metadata.lua"  --lua-filter="./pandoc_lua_filters/pagebreak.lua" --filter=pandoc-crossref --citeproc --bibliography="./references.bib" -o article.docx
 ```