What is missing from markdown? mdbook also uses in some parts the GH flavored one, so you can create notes [1] and similar. On top of that, you can add support for Mermaid.

Personally, I don't think you need more than that for 90% of the documentation, but I'm happy to hear more about your use case.

[1]: https://github.com/orgs/community/discussions/16925