Markdown, HTML and Liquid

The pages of our site are primarily formatted via markdown and HTML.

Markdown

Markdown is a lightweight and easy-to-use syntax for styling texts. Mostly, Markdown is just regular text with a few non-alphabetic characters thrown in, like # or *. GitHub offers a very concise guide for Markdown.

A more complete guide, which is also specifically oriented towards Kramdown (the Markdown processor our website uses), can be found here.

HTML

Behind the scenes Markdown is converted to HTML code. This allows us to use HTML in-between all the markdown. This is especially useful for flexible styling and more elaborate widgets (in particular, when involving Javascript).

Liquid

Liquid is Jekyll's templating language. It has support for variables (usually dealt with in two curly braces, e.g. {{ variable }}) and performing logic statements (e.g. {% if statement %}). Find out more in the Liquid documentation.