Pandoc can be pretty useful as a general purpose templating system that allows you to write your content in Markdown files and create various documents such as articles, slideshows, and websites from it. This repository contains some example files that demonstrate this approach and can be used as template for new projects.
Advantages: The content is reasonably separate from its presentation, allowing to focus on the structure of the content when writing it. Furthermore, this approach works very well with version control. Disadvantages: It can be hard to change certain aspects of the output documents and that it is difficult to collaborate with people who are not comfortable working with plain-text files.
Makefiles are useful to store the commands that build the documents and can also be used to download Pandoc itself. Since make
is available on most Linux systems it often doesn’t even need to be installed explicitly. Alternatives such as just may be preferable if you prefer a more modern and simple tool.
entr provides a convenient way to rerun a build command whenever the input files have changed. You still have to reload the browser though for web-based output, unless you use a browser extension or local web server that implement live reload functionality.
The Pandoc manual has many relevant details. The section on Pandoc’s Markdown is particularly useful.