I had the exact same experience. Everything that sucked about hugo that I discovered only after a week of trying to do something simple with it was fixed with mkdocs.
It made me appreciate that static site generators look easy up front but are actually a huge amount of work to do right.
It made me appreciate that static site generators look easy up front but are actually a huge amount of work to do right.