Markdown reference for Jekyll websites

less than 1 minute read

Having a good website template helps your website performance substantially (> 10%) by speeding up the site and making it more mobile-friendly. 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.




Leave a Comment