When I wrote my portfolio I intentionally did it in markdown, with a hope that it could be reusable as a GitHub profile page thing...

Well that seems to have worked nicely!
See for yourself in https://github.com/falkTX
(the same is then also pushed into https://falktx.berlin/portfolio/ of course)

What do you think?