Hacker News new | ask | show | jobs
by pksunkara 3930 days ago
What do you think about API Blueprint [1]? It is based on Markdown.

[1]: https://apiblueprint.org
1 comments
mpdehaan2 3925 days 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.

link