noureddine-as / pandoc-templates

Simple templates for articles and slides in LaTeX generated with Markdown and Pandoc

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

pandoc-templates

Did you know that you can create beautiful LaTeX documents without writing in LaTeX? Thanks to Pandoc, one can write in Markdown (the same simple markup language used to write this README) and then "compile" the file in LaTeX to produce a PDF. In this way you write less code and the source is more readable.

You can still add LaTeX code directly in the Markdown files, or in a custom preamble.

I created two examples of the use of this tool:

  • article: a simple LaTeX article demo
  • beamer: a simple slideshow using the Beamer LaTeX package

How to install (OS X)

  1. Install LaTeX, simply downloading and installing the latest version of MacTeX.
  2. Install Xcode, or at least Xcode Command Line Tools, if not already installed.
  3. Install Homebrew.
  4. Install pandoc using Homebrew: brew install pandoc

Usage

  1. Clone a template.
  2. Edit it with your favorite editor.
  3. Run make to run pandoc.

Files

  • header.tex: your custom LaTeX header. Useful for including packages and make customizations. It will be included at the end of the preamble, before \begin{document}.
  • main.md, slide.md: Markdown files with the content of the document.
  • main.pdf, slide.pdf: the final output of Pandoc.
  • Makefile: the Makefile specifying Pandoc options and input files.
  • metadata.yaml: a YAML file containing settings and metadata for Pandoc. here you can customize things like title, author, paper format, etc. For a full list of options, refer to the Pandoc guide.

License

All the material in this repository is in the public domain and freely reusable. No rights reserved.

References

About

Simple templates for articles and slides in LaTeX generated with Markdown and Pandoc


Languages

Language:Makefile 92.6%Language:TeX 7.4%