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 <input.json> <output.md>
From Python
import jsonschema2md
parser = jsonschema2md.Parser()
md_lines = parser.parse_schema(json.load(input_json))
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.
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
Built Distribution
Close
Hashes for jsonschema2md-0.2.0.post1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 86a25efcd7b25e2ba90e067648fbc3b2a9b7fece58b4fd7aa8d527a9d5b2c4af |
|
MD5 | 632743a41d10e584a52b2129ad89f62d |
|
BLAKE2b-256 | c9b23428ab07f308f09844277044d5ac2d96d8dfb895f9cb71352dcf6bd23737 |
Close
Hashes for jsonschema2md-0.2.0.post1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b79bbc2c2b102976189842101d6eb9c20a198c9bb66580248d24340e6c9b6e1b |
|
MD5 | 95a08416ea4846be08b7c1dbbe5b9f26 |
|
BLAKE2b-256 | f6b4b9db9253de36922a48b86bab53e87709583675af473bb0e4c42ad8514b25 |