Can you embed markdown in OpenAPI?

Question

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

score 3 · Accepted Answer · answered Apr 04 '22 at 17:03

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.

1 Answers1