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.
Headers
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.
Links
you build a link like this: [what the link displays](http://the.link.goes.here)
example bellow links 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:
{: 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.
Videos
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.