title: A fancy title subtitle: An optional subtitle author: Jeremy Theler fontsize: 11pt lang: en numbersections: true formats: html tex pdf template: light …
Because the generation of documentation is completely creepy using traditional (i.e. word processors).
Write in Markdown. Track with Git. Read in
Focus on the content. Use headers, lists, tables (through Pandoc extension), etc.
Track changes. Collaborate. Get the hash of the latest commit into the resulting document.
Actually M4 macros can be expanded, Bash hooks can be executed, Pandoc filters can be used and templates can be fully customized.