Here is a nice blog post comparing PlantUML and Mermaid.js. Both are tools for generating diagrams from yaml files, but PlantUML appears to be more fully featured. Something I am considering for use in designing an APIOps pipeline.
Also worth mention this tool, that can be used to generate a PlantUML class diagram from an OpenAPI specification. Worth considering when working backwards from an OpenAPI spec to an abstract resource model.