fix the markdown pages

This will render the nested markdown on the shogun main page. I also added the instructions on how to update the md using the script. Its all a bit hacky but it works ...