You might look at DocBook. I haven't used it in ~25 years, and then only for short documents, and it is XML hence quite verbose.

But it's explicitly targeted at technical documentation. If nothing else, searching for DocBook alternatives might give you some ideas.

Thanks!