RESTful API doc spec & API Blueprint awesome resources

API Doc Specs

Introdce to API Doc Spec

Misc articles


Swagger is a simple yet powerful representation of your RESTful API. Swagger Specification has been donated to the Open API Initiative (OAI) and has been renamed to the OpenAPI Specification.


The simplest way to design APIs

RESTful API Modeling Language (RAML) makes it easy to manage the whole API lifecycle from design to sharing. It’s concise - you only write what you need to define - and reusable. It is machine readable API design that is actually human friendly.

Write once. Use many. Creative laziness encouraged.


Slate helps you create beautiful, intelligent, responsive API documentation.


API Blueprint

Getting Start / Tutorial

MSON (Markdown Syntax for Object Notation)


An API Blueprint renderer that supports multiple themes and outputs static HTML that can be served by any web host. API Blueprint is a Markdown-based document format that lets you write API descriptions and documentation in a simple and straightforward way.