> Swagger and RAML are really similar, but RAML 1.0 uses its own YAML-based format to describe entities.

Swagger actually uses either JSON or YAML that conforms to JSON-API, but YAML is the default in its editor web app. So they're even more similar than the article suggests. Check it out at http://editor.swagger.io/