Been playing with VuePress and so far it is pretty nice. I haven't ran into any weirdness other than README.md is somehow index.html ('cause fuck you 30 years of WWW).