Skip to main content

JSON Schema renderer for Sphinx

Project description

A JSON Schema renderer for Sphinx


As simple as it can be with pip:

pip install sphinx-json-schema


Add the extension name to your

extensions = [

If necessary, add a root directory to look for json schemas:

json_schema_root_dir = os.path.join('path', 'to', 'root', 'dir')

In your documentation:

.. json-schema:: path/to/json/schema.json

The file is looked up relatively from the .rst file the directive is called in, or, if not found from the json_schema_root_dir specified in the file.

allOf, oneOf, anyOf, not support

sphinx_json_schema supports the allOf, oneOf, anyOf and not keywords. It can also parse references to other schemas. The final JSON output is the result of the operations and inclusions of other schemas. This means it can be quite long even if the original .json file is very short!


This is still experimental

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for sphinx-json-schema, version 0.1b6
Filename, size File type Python version Upload date Hashes
Filename, size sphinx_json_schema-0.1b6.tar.gz (6.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page