Front Matter

the stuff at the top of a post is the front matter. it dictates how this file is rendered to the static website.

here is some front matter for a post (make sure its in the _posts folder, and it’s title matches the format $year-$month-$day-post-title-with-dashs.markdown)

layout: post
title: the title of the post
date: 2018-11-30

you can copy this, into your new file. just make sure the date is correct, and the add the category: "2018 Rover Ruckus" to it somewhere.

you can also mark a post as not to be posted yet by adding publish: false to its front matter.


you can make things headers using the # character. examples bellow.

# header 1
## header 2
### header 3
#### header 4
##### header 5
###### header 6

these headers get smaller the larger number they have.

you can also mark headers by putting ==== under a line. example bellow.

A header 1

Styling Text

you can bold things like this: **this is bold**

bold things can be put anywhere in a sentence.

italics are equally as simple: *italics.*

we can combine italics and bold if we want.

strike-through stuff with double ~~like this~~.

like bolding and italics, strike-through can also be in the middle of sentences.

you build a link like this: [what the link displays]( example bellow links to google.

this goes to google!

Embedding Media

photos and images

you can embed a photo by using this template: !()[link/to/the/image]

as images go in the assets/img/ folder, an example would be like this:


you can change the height and width of the image like so:

![](/assets/img/shield.png){: height="300px"}

you can set both height and width, or one or the other.

the above also works with videos, although those should go on YouTube. see bellow.


you can embed a YouTube video with the following code:

{%- include widgets/youtube-player.html video='the video's ID' -%}

Further Reading

the only things on this page that are specific to our website is the YouTube embedding stuff. a more exhaustive source on markdown is available Here.