danielgtaylor/aglio

Aglio is a tool that converts API Blueprint files into static HTML documentation pages. API Blueprint is a Markdown-based format for writing descriptions of HTTP APIs: you write plain text files that describe your endpoints, the parameters they accept, and example request and response bodies, then use a tool like Aglio to turn those files into readable, styled documentation you can share with developers or host on any web server. The generated HTML works on any standard web host without special setup. Aglio supports several built-in visual themes, including options named streak, flatly, slate, and cyborg, and can produce either a two-column or three-column page layout. You can also supply your own custom templates if none of the defaults suit your needs. The tool has three modes of use. As a command-line program, you point it at an input Blueprint file and it writes an HTML file. You can also run it in server mode, which watches the input file for changes and serves a live-reloading preview in a browser as you write. The third option is calling it as a Node.js library, which lets you invoke the HTML rendering step from your own code and pass custom options or template variables. Aglio supports splitting large API descriptions across multiple files using an include directive, so you can organize a complex API into smaller, manageable sections that are stitched together at render time. The README notes that the project is mature and stable but is no longer actively maintained by the original author. The project is released under the MIT license.