A framework to use pandoc and managing its options efficiently

[mh4ckt3mh4ckt1c4s]

Hello everybody,

I'm using pandoc a lot for presentations, papers and other documents. I was not satisfied with my workflow when using pandoc, for several reasons :

• I am using a lot of options, and putting every needed option in a file as a command line command was not readable or easy to modify ;
• A good part of these options are the same from a document to another, and yet I was constantly referring to pandoc's documentation for the correct option spelling, and frequently forgetting about options I used before ;
• Sometimes my builds were not reproducible (not the same version of pandoc or LaTeX libraries), which is a pain to troubleshoot and a waste of time.

That's why I created the ultimate pandoc framework, that allows for easy, reproducible builds with all of the general options of pandoc quickly available and configurable in yaml files. I created this framework for my main workflow (md -> latex -> article or beamer pdf), so I also added all of the LaTeX / beamer-specific options, but it can be easily adapted for all formats supported by pandoc. Each option is quickly explained in comments, which allows to understand the configuration of a project and change it quite easily.

I'm sharing this project here in the hope that it can help other people use pandoc more efficiently. I am open for all kinds of feedbacks, remarks or questions. Enjoy!