GitHub Pages

Create a site or blog from your GitHub repositories with GitHub Pages.

Step 4: Create a blog post

Your home page is looking great! :cowboyhatface:

GitHub Pages uses Jekyll. In Jekyll, we can create a blog by using specially named files and frontmatter. The files must be named _posts/YYYY-MM-DD-title.md. You must also include title and date in your frontmatter.

What is frontmatter?: The syntax Jekyll files use is called YAML frontmatter. It goes at the top of your file and looks something like this:

---
title: "Welcome to my blog"
date: 2019-01-20
---

For more information about configuring front matter, see the Jekyll frontmatter documentation.

:keyboard: Activity: Create a blog post

• Browse to the my-pages branch.
• Click the Add file dropdown menu and then on Create new file.
• Name the file _posts/YYYY-MM-DD-title.md.
• Replace the YYYY-MM-DD with today's date, and change the title of your first blog post if you'd like.

> If you do edit the title, make sure there are hyphens between your words. > If your blog post date doesn't follow the correct date convention, you'll receive an error and your site won't build. For more information, see "Page build failed: Invalid post date".

• Type the following content at the top of your blog post:

---
   title: "YOUR-TITLE"
   date: YYYY-MM-DD
   ---

• Replace YOUR-TITLE with the title for your blog post.
• Replace YYYY-MM-DD with today's date.
• Type a quick draft of your blog post. Remember, you can always edit it later.
• Commit your changes to your branch.
• Wait about 20 seconds then refresh this page (the one you're following instructions from). GitHub Actions will automatically update to the next step.