Making a Free Webpage with GitHub Pages

Tool Logo

Making a Free Webpage with GitHub Pages

In this workshop, attendees will learn how to host free webpages on GitHub. The process to make a basic, single page site is surprisingly easy and provides an excellent alternative to paid hosting options as not only is it free, but it allows for full control over the site at all times and it will exist forever! This workshop is the third in the GitHub Workshop Series offered by the Brock University Digital Scholarship Lab.

A basic understanding of using repositories in GitHub is recommended for this workshop.

Estimated workshop length: 1.5 hours


In preparation for this workshop, you will need the following:

Helpful Materials

Markdown Cheat Sheet: This is a helpful cheat sheet showing the common Markdown syntax. Excellent for experienced users and beginners alike!

Workshop Tasks

Task Set 1

  1. Navigate to your GitHub repository and add an image of any kind using the “Add file” button
  2. Edit your README file and add at least two sizes of heading (Use #’s), some bold text (Use **), some italic text (Use *), a link to a web location of your choice (Use ), and add your image to your page (Use and remember that if the file is in a folder you need to use its full path)
  3. Try out some of the other elements shown in the Markdown Cheat sheet (I am personally a fan of using “Horizontal Rule” to break up pages and “Footnotes” for in text citations or references)
  4. Once you have finished editing your README file and are happy with the preview, commit your changes with an appropriate commit message
  5. Once you have done all that, type “MARKDOWN MASTERED!!!!” in the chat to let me know you are ready to move on

Task Set 2

  1. Navigate to your repositories settings using the “Settings” tab and then click on “Pages” in the menu on the left
  2. Choose a theme for your site by clicking on the “Change theme” button, picking the theme you want, and then clicking the green ”Select theme” button at the top right of the page
  3. Set the source for your site to the “main” branch from the dropdown menu and the click “Save” to start building you site.
  4. Wait a couple minutes then click the link to see your new webpage! Feel free to share the link to your page in the chat for others to see!
  5. Once you have admired your site, type “SITE CREATED!!!!” in the chat to let me know you are ready to move on

BONUS! Try making another Markdown file and making a link to and from your main page and that new page

Next Steps

After completing this workshop, the recommended next steps are:

This workshop is brought to you by the Brock University Digital Scholarship Lab. For a listing of our upcoming workshops go to Experience BU if you are a Brock affiliate or Eventbrite page for external attendees.