GitHub Pages: How do I edit this page in markdown format, just as I created it?

Louis93 picture Louis93 · Feb 23, 2013 · Viewed 18k times · Source

I'm not too comfortable with touching the generated HTML that the site gives, I was wondering whether there is any way to change the contents of my page in markdown formatting, the same way that I did upon creating the page?

Any input as to go about doing this would be awesome.

Answer

VonC picture VonC · Feb 24, 2013

By default, GitHub Pages helps you generate html pages only.

But if you setup your site to use jekyll, then you can store files in markdown. For example, in the _posts section of this repo 'cboettig/labnotebook' which is generated to carlboettiger.info.

See Help page "Using Jekyll with Pages"

More specifically (as highlighted in esfandia's answer), see "The Automatic Page Generator", which allows for markdown editing.

https://help.github.com/assets/images/help/pages/pages-automatic-page-generator.png

As commented by dregad, there is a new theme chooser in Dec. 2016:

https://cloud.githubusercontent.com/assets/849592/21229008/24006df6-c2ae-11e6-94a4-ca4eb085f5f4.png

See this article by Antriksh Yadav:

http://antrikshy.com/assets/github-page-generator-edit.png


Update August 2016: Simpler GitHub Pages publishing now allows to keep your page files in a subfolder of the same branch (no more gh-pages needed):

Now you can select a source in your repository settings and GitHub Pages will look for your content there.

So you don't need multiple branch anymore.