MSON and API Blueprint


#1

While not really extensions (dialects? interpreters?), I thought I’d post this here. A search for MSON didn’t bring anything and I’m sure it will interest people here if they don’t yet know about it. Here’s the Github repo https://github.com/apiaryio/mson with examples and the spec.

# Product
A product from Acme's catalog

## Properties

- id: 1 (number, required) - The unique identifier for a product
- name: A green door (string, required) - Name of the product
- price: 12.50 (number, required)
- tags: home, green (array[string])

This example is able to generate JSON Schema which is pretty sweet.

It’s used as part of the API Blueprint spec https://github.com/apiaryio/api-blueprint which is another thought provoking use of Markdown.

# GET /message
+ Response 200 (text/plain)

        Hello World!

This example is able to generate a mock API as well as of course be used for documentation.

One of the things that come out of this, is a transclusion syntax I’ve mentioned here Transclusion or including sub-documents for reuse