Skip to content
Snippets Groups Projects
Select Git revision
  • main default protected
1 result
Name Last commit Last update
.vscode
Makefile
README.md
header.md
latexmkrc
README.md

Markdown Notes

This is my template for my note-taking workflow. I write the notes in Pandoc Markdown and render them using LaTeX.

This repository contains my Pandoc Markdown YAML metadata block to configure document metadata, fonts etc. as well as a Makefile to render the document to PDF.

It also includes two VSCode build tasks to build the files from within the editor.

The Header

The document uses the Libertinus fonts with Inconsolata for monospace text. These are the fonts also used in the ACM article template.

The Makefile

Pandoc can compile directly from Markdown to PDF (which still converts to .tex internally). The makefile uses Pandoc to convert to LaTeX and then render the document with latexmk to optimize the number of compilation runs.

The intermediate files are stored in the .build directory.

The latexmkrc file in this repository contains configuration for latexmk. Use of this file enables automatic conversion of SVG graphics included in Markdown files.

The Build Tasks

The .vscode folder contains two build tasks to convert documents from Markdown to PDF in the VSCode editor. The pandoc md -> pdf task converts directly from Markdown to PDF without producing intermediate LaTeX files. The GNU make (default recipe) executes the default make recipe in the folder of the currently opened file.