A small suggestion. Since Jupyter Notebook can be used for both programming and documentation, why don't you use Jupyter Notebook itself as the source of your

A small suggestion. Since Jupyter Notebook can be used for both programming and documentation, why don't you use Jupyter Notebook itself as the source of your document? It is actually very easy to setup a Jupyter Notebook driven .ipynb -> .html publishing pipeline with github + a local Jupyter instance Here is a toy example (for my own github page) https://ontouchstart.github.io/ https://ontouchstart.github.io/ https://github.com/ontouchstart/ontouchstart.github.io https://github.com/ontouchstart/ontouchstart.github.io The convert script is here (also a Jupyter Notebook) https://github.com/ontouchstart/ontouchstart.github.io/blob/master/convert.ipynb https://github.com/ontouchstart/ontouchstart.github.io/blob/... You got the ideas.