Skip to main content

Building your own website with your github repository

2 min read

Now you've learned how github works, here's a neat way of getting a personal website/journal/open notebook up and running. 

1. Fork this repository

2. Rename your copy of the repository in the settings, by hitting the cogwheel icon, and changing the repo name from 'jeckyll-noww' to  (with no )

3. Click 'rename'.  Scroll down - see the green bar that says 'your site is published at!' (yours'll be different, of course). Click on that link - your site is live!

4. If it isn't, we'll just give Github a nudge. On the main page for your repo, click on the file called _config.yml 

5. Click the pencil icon, so you can edit it. Change line 6, to put in your name. Go to the bottom of the page and hit the green commit changes button. Open a new browser window, put the URL in: and ta da!

A more detailed set of instructions is at


You can add new posts to your new blog by cloning the repo on your desktop, and then saving .md files into the  _posts folder. Note that the naming convention has to be the same as the example post. Then sync with your repo, and your changes are published to the web! 

There are lots of reasons why you might do this, but two very good ones is a) free b) you keep control because your materials are on your own machine c) it's fast - the site is static and so no time is wasted computing what the page ought to look like d) it's secure. Well, more secure than many options (ask me about the Heritage Crowd project sometime).