Hacker News Reader

As discussed in the MSON README - there is this Markdown format for documenting APIs; discussing / describing API payloads and resources in JSON Schema felt complex and not suiting well the settings of a Markdown document.

Besides some payloads are not just a JSON. So there is a need to describe these data in a media-type agnostic form.

Ok sorry if my question came off as snarky, the first example in your readme shows how mson can be converted to json which doesn't seem to be very useful.

I think you should better highlight the connection to json schema.

Also json schema is new to me. Any examples of it being used in the wild?

Writing JSON Schema by hand and embedding it into Markdown sucks. MSON provides a Markdown-compatible way.

Writing JSON by hand sucks?