CODEWITHSUNDEEP
yamlopenapijsonpointer
Archimedes Trajano
Archimedes Trajano

Reputation: 41300

Can you embed markdown in OpenAPI?

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

Upvotes: 3

Views: 1456

Answers (1)

Archimedes Trajano
Archimedes Trajano

Reputation: 41300

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.

Upvotes: 5

Related Questions