Can you embed markdown in OpenAPI?

1.2k Views Asked by At

I presently have

openapi: 3.1.0
info:
  title: My API
  version:
    $ref: package.json#/version
  description: |
    practically the same content as README.md

Is there a way with JSON Pointers to embed text rather than JSON object? Something along the lines of

openapi: 3.1.0
info:
  title: My API
  version:
    $ref: package.json#/version
  description: |
    $ref: README.md
1

There are 1 best solutions below

0
On BEST ANSWER

Actually I was close and it did work. I didn't expect it to

openapi: 3.1.0
info:
  title:
    $ref: package.json#/description
  version:
    $ref: package.json#/version
  description:
    $ref: README.md

So now I basically avoided repeating myself for the title, version and the description.