How do I get a multipage site from GitHub Pages' automatic generator?

You pull the generated page, make any modification and addition you like (including adding new pages and links between the pages), then commit and push.

The generated single page helps you to make you start. You can duplicate its layout to generate other similar-looking pages by hand.

See Help.

You can get github to generate .html files from .markdown files by ensuring the top of the .markdown starts with the ---- block like this:

---
title: This will be used as the title-tag of the page head
---

hello
=====

**You are here!**

Found this here: http://xlson.com/2010/11/09/getting-started-with-github-pages.html

Github will automatically create pages for you, if you include the markdown file.

• index.html - yourname.github.io/project-name/
• about.md - yourname.github.io/project-name/about
• foo.md - yourname.github.io/project-name/foo

Tested this and working.

If you want to get into the really fun stuff - you need to get into Jekyll http://jekyllrb.com/

Github Pages uses the Jekyll site generator which suports converting any number of markdown files to HTML for you, and applying the surrounding template via a layout file. See github's documentation on using Jekyll: https://help.github.com/articles/using-jekyll-with-pages

The trick is that you have to download a jekyll template/theme and include it in your gh-pages branch on your own (standard jekyll configuration), instead of just allowing Github Pages to auto-generate the one file using its own built-in themes.