5 ms·
What do you think about API Blueprint [1]? It is based on Markdown. [1]: https://apiblueprint.org https://apiblueprint.org
by pksunkara 11y ago
What do you think about API Blueprint [1]? It is based on Markdown.
[1]: https://apiblueprint.org https://apiblueprint.org
- mpdehaan2 11y agoI 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.