jekyll-swagger is a Jekyll layout that allow you to include a Swagger API documentation directly in a page. Checkout examples to see how it renders!

Bonus: jekyll-swagger works with GitHub pages!

Usage instruction

  1. Download jekyll-swagger (you can also clone it).
  2. Copy _layouts/swagger.html and _saas/_swagger.scss into your jekyll site.
  3. Add import swagger in css/main.scss (like here)
  4. You can now create pages with the swagger layout (layout: swagger).

Swagger API doc can be either within the page or in a separate file and specified in your page with data front matter (like here).


jekyll-swagger is released under the MIT License. See LICENSE file for details.

The official site for the library is at