View .rst on github pages

Question

I am moving the open source documentation to Github pages, but I am fixated on moving .rst files.

We have ReadMe.rst, which you can see here here . I would like to link this page to our main documentation page , but GitHub does not display .rst as HTML, so the browser just loads the text of the .rst file when you click the link ).

There are, of course, tools for rendering .rst as HTML, but this is a serious additional step. The whole reason we started using .rst was entirely due to the fact that GitHub automatically displays it on code pages. You might think that there is some way to get this automatic rendering for Github pages ...

Answer 1

GitHub Pages lacks support for .rst / RestructuredText. It supports the conversion of Markdown and Textile to HTML.