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