# MSON and API Blueprint

**URL:** <https://talk.commonmark.org/t/mson-and-api-blueprint/2072>\
**Category:** Extensions\
**Created:** [April 8, 2016, 7:21am UTC](https://talk.commonmark.org/t/mson-and-api-blueprint/2072 "2016-04-08T07:21:34Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![jmatsushita](https://cdn.commonmark.org/user_avatar/talk.commonmark.org/jmatsushita/32/957_2.png) [@jmatsushita](https://talk.commonmark.org/u/jmatsushita)\
**Post date:** [April 8, 2016, 7:21am UTC](https://talk.commonmark.org/t/mson-and-api-blueprint/2072/1 "2016-04-08T07:21:34Z")

</div>

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](https://github.com/apiaryio/mson) with examples and the spec.

```auto
# 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](https://github.com/apiaryio/api-blueprint) which is another thought provoking use of Markdown.

```auto
# 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](http://talk.commonmark.org/t/transclusion-or-including-sub-documents-for-reuse/270/8)