Example Markdown Post

Basic setup

Jekyll requires blog post files to be named according to the following format:


Where YEAR is a four-digit number, MONTH and DAY are both two-digit numbers, and filename is whatever file name you choose, to remind yourself what this post is about. .md is the file extension for markdown files.

The first line of the file should start with a single hash character, then a space, then your title. This is how you create a “level 1 heading” in markdown. Then you can create level 2, 3, etc headings as you wish but repeating the hash character, such as you see in the line ## File names above.

Basic formatting

You can use italics, bold, code font text, and create links. Here’s a footnote 1. Here’s a horizontal rule:


Here’s a list:

  • item 1
  • item 2

And a numbered list:

  1. item 1
  2. item 2

Boxes and stuff

This is a quotation

You can include alert boxes


You can include info boxes



You can format text and code per usual

General preformatted text:

# Do a thing

Python code and output:

# Prints '2'

Formatting text as shell commands:

echo "hello world"
./some_script.sh --option "value"
wget https://example.com/cat_photo1.png

Formatting text as YAML:

key: value
- another_key: "another value"


Column 1 Column 2
A thing Another thing



  1. This is the footnote.