Convert JSON Schema to human-readable Markdown documentation
Project description
jsonschema2md
Convert JSON Schemas to simple, human-readable Markdown documentation.
For example:
{
"$id": "https://example.com/person.schema.json",
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Person",
"description": "JSON Schema for a person object.",
"type": "object",
"properties": {
"firstName": {
"type": "string",
"description": "The person's first name."
},
"lastName": {
"type": "string",
"description": "The person's last name."
}
}
}
will be converted to:
Person
JSON Schema for a person object.
Properties
firstName
(string): The person's first name.lastName
(string): The person's last name.
See the examples directory for more elaborate examples.
Installation
Install with pip
pip install jsonschema2md
Usage
From the CLI
jsonschema2md [OPTIONS] <input.json> <output.md>
From Python
import json
import jsonschema2md
parser = jsonschema2md.Parser(
examples_as_yaml=False,
show_examples="all",
)
with open("./examples/food.json", "r") as json_file:
md_lines = parser.parse_schema(json.load(json_file))
print(''.join(md_lines))
Options
examples-as-yaml
: Parse examples in YAML-format instead of JSON. (bool
, default:False
)show-examples
: Parse examples for only the main object, only properties, or all. (str
, defaultall
, options:object
,properties
,all
)
pre-commit hook
You can use the pre-commit hook with:
repos:
- repo: https://github.com/sbrunner/jsonschema2md
rev: <version> # Use the ref you want to point at
hooks:
- id: jsonschema2md
files: schema.json
args:
- --pre-commit
- schema.json
- schema.md
Contributing
Bugs, questions or suggestions? Feel free to post an issue in the issue tracker or to make a pull request! See Contributing.md for more info.
Install the pre-commit hooks:
pip install pre-commit
pre-commit install --allow-missing-config
Changelog
See Changelog.md.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
jsonschema2md2-1.3.0.tar.gz
(9.8 kB
view hashes)
Built Distribution
Close
Hashes for jsonschema2md2-1.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | abe817c90bb37d1b06159267b6a0a3da055050ebb82e158d89b9d21c9229687a |
|
MD5 | 10d74f0dfd31bff132ff402fdacb330e |
|
BLAKE2b-256 | d917a3768133b0b51980b935988f6d7a364f3ddf22a149005a82bb044564b593 |