top | item 10200645

(no title)

pksunkara | 10 years ago

What do you think about API Blueprint [1]? It is based on Markdown.

[1]: https://apiblueprint.org

discuss

order

mpdehaan2|10 years ago

I think Markdown is generally unsuitable as a data format for machines.

YAML strikes a nice balance between machines and people, but I wouldn't want to write a blog post in it.

Markdown is great for blog posts, but APIs are terse.