I have tried using raml2pdf to generate documentation for raml . It is well formatted and generates it effectively.
Has anyone else used the tool and can let me know a mechanism to be able to support inline reference to schemas as below:
example: !include samples/getSubProfileResponse.json
schema: !include schemas/getSubProfileResponse.schema.json
In this case there is reference to sample schema and example .