You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

756B


title: A fancy title subtitle: An optional subtitle author: Jeremy Theler fontsize: 11pt lang: en numbersections: true formats: html tex pdf template: light …

Why

Because the generation of documentation is completely creepy using traditional (i.e. word processors).

How

Write in Markdown. Track with Git. Read in

  • HTML
  • PDF (through XeTeX)
  • $\dots$ (whatever Pandoc converts to)

What

Markdown

Focus on the content. Use headers, lists, tables (through Pandoc extension), etc.

Git

Track changes. Collaborate. Get the hash of the latest commit into the resulting document.

Advaced tweaks

Actually M4 macros can be expanded, Bash hooks can be executed, Pandoc filters can be used and templates can be fully customized.