Markdown reference for Jekyll websites

Related: Create fast Jekyll GitHub Pages website

Having a good website template helps your website performance substantially (> 10%) by speeding up the site and making it more mobile-friendly. Mobile-friendly websites have been important (including for low-bandwidth users on any device) and feasible since the late 1990s with CSS. As Google has moved to a mobile-first web crawler, the important of being mobile-friendly is of critical importance for virtually all websites. Using appropriate layout elements in the page help your visitors and search engines understand the content better, boosting engagement rates and SERPP (search engine results page position).

The Wordpress Markdown syntax reference applies equally well to Jekyll and other website renderers that accept Markdown input. I would estimate that for this website, the individual page content layout is done over 99% by Markdown.

I only use HTML directly to:

  • draw text arrows ↔
  • give detailed control of a few percent of images on this site
  • highlight text (e.g. red warning text)

I use Liquid to generate:

  • almost all figures
  • table of contents
  • image galleries

HTML5 math character

Math characters directly in HTML5 Not all of these work in Jekyll Markdown, test them in the local preview first.