> other than diagrams
Works fine with some help https://mermaid.live/ https://github.blog/developer-skills/github/include-diagrams...
No, mermaid is not fine. You don't have fine control over layout and composition, you can't place your own media and annotations where you like, you can't even use the correct icons for things like databases and cloud services. I usually go into Figma for anything more complex than about 7 entities or if I need to tell a story with composition.
A mix plantuml for constrained no-frills diffable standard diagrams and yEd for actual manual placement and boxes-and-arrows drawing - local editing, both can be scripted to export to an image format - is a good local optimum. I haven't found a much better combination for years.
I agree. I use markdown a lot and was trying to use Mermaid for diagrams in it and it was frustrating. Among the biggest issues I ran into was that text was constantly cut off or covered up.