# Create an HTML version of an OpenAPI spec

DevFeed: [Create an HTML version of an OpenAPI spec](<https://devfeed.tech/articles/create-an-html-version-of-an-openapi-spec-39465.md>)

Original publisher: [Read original article](<https://akrabat.com/create-an-html-version-of-an-openapi-spec/>)

Author: Rob

Published: 2026-03-17T11:00:00Z

Content type: tutorial

Language: en

Sources: [Rob Allen](<https://devfeed.tech/sources/rob-allen.md>)

Topics: [OpenAPI Specification](<https://devfeed.tech/topics/openapi.md>), [HTML](<https://devfeed.tech/topics/html.md>), [Shell](<https://devfeed.tech/topics/shell.md>), [Script](<https://devfeed.tech/topics/script.md>)

Tags: [api](<https://devfeed.tech/tags/api.md>), [html](<https://devfeed.tech/tags/html.md>), [openapi](<https://devfeed.tech/tags/openapi.md>), [script](<https://devfeed.tech/tags/script.md>), [shell](<https://devfeed.tech/tags/shell.md>)

## AI overview

A short shell script uses Scalar to convert OpenAPI specification JSON files into formatted HTML documents, making third-party API specifications easier to read.

## Source excerpt

I have a new project where we will be integrating with a third party API that is currently being written. Due to Conway's Law, we are being sent new versions of the OpenAPI spec as a set of JSON files via email. I quite like seeing the HTML rendering of an OpenAPI spec when reading it and understanding it, so I knocked up a simple shell script that takes an OpenAPI spec file and outputs... continue reading.