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

Question

I am using the 'Automatic Generator' of GitHub Pages, and I see it only generates a single index.html and other web resources.

How it works if I want to have a multi-page website generated from other markdown files?

Answer 1

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

Answer 2

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/