The Markdown Syntax for Object Notation (MSON) is a plain-text syntax for the description and validation of data structures in API Blueprint. It provides a way to represent objects (for example, an artist) in a human-readable plain text form.
It is recommended to use MSON data structures over plain JSON objects when defining Request/Response payloads. Using MSON provides consistency and reusability across the entire API blueprint definition. This is the case because data structures can be defined just once and then referenced from all resource actions, as opposed to having to define plain JSON objects multiple times, which is prompt to human error and data structure inconsistencies.
The full MSON specification ...
