Comment by nrhrjrjrjtntbt

It is not features but structure and undetstanding that is missing.

That said I am not sure what the solution is to that since your docs may need structure my docs dont need. Therefore you cant solve the "semantic" outside of a "namespace" of what you agree in your organization.

E.g. you may decide architecture diagrams are in Mermaid but that is by no means a stanfard and my org uses embeded svg.

So to go full circle... you are right just use HTML. After all it's semantic isn't it ;-)