Lesson 5 - Making a Post

Front matter

You'll always want to define the front matter above. I've included a file in this folder called template.md with empty front matter, so you can copy that and fill in your front matter.

Featured image

Add an image to the content/img/ folder, and write the filename exactly as it appears, including capital letters if necessary. I recommend naming your images the same thing as your posts so they are somewhat organized.

Inside the img/ folder, I've added a folder 2026/. You can see in the front matter of this post that 2026/ is in the image filename. This is important! All image filenames for posts must be relative to the content/img/ folder.

Alternative text, or alt text, is necessary for the image to show up. This is not something I can control! The image plugin fails without alt text. However, you can provide empty alt text in the following way:

image:
  src: filename.jpg
  alt: "" # note the quotations

I recommend against this. Alternative text is part of an accessible website.

Post body

Use all the tricks in the previous lesson pages to write your post with formatting, headers, and more. Well-structured headers assist greatly with readability, especially in longer posts.