# A first-level title
## A second-level title
### A third-level title
error) with the quote markdown syntax (lines starting with
>) if the first line contains one of the call-out types.
$ref: "./path/to/local-markdown.md". In the same way you can extract part of your contract (usually JSON schema of your models into dedicated
*.jsonfiles), you can extract your markdown content into dedicated files too.
api-contract.ymlcan thus looks like:
docs/use-cases-examples.mdright next to your contract document, you will be able to generate a comprehensive API documentation with nicely formatted content for your users.
x-topicsproperty at the root of your documentation specification will let you add some content sections at the beginning of your documentation.