I completely agree with the author and love the idea, however I'm more of a Vue guy. The system the author is describing already exists for Vue.js, it's called VuePress[0]. I think it's amazing, not only for docs but also for blogs, portfolios, etc.
Shameless plug but for an example you can check out how it's used in one of the tutorials about VuePress I'm writing.
This link will take you to a Vue component used inside a markdown file:
Shameless plug but for an example you can check out how it's used in one of the tutorials about VuePress I'm writing. This link will take you to a Vue component used inside a markdown file:
https://willwillems.com/posts/building-a-website-with-vuepre...
And naturally the source[1] is available online.
[0] https://http://vuepress.vuejs.org/
[1] https://github.com/NickolasBoyer/willwillems/blob/master/pos...