JSON Schema for Humans vs StepShot
JSON Schema for Humans
json-schema-for-humans.readthedocs.ioStepShot
stepshot.appSide by side
| Figure | JSON Schema for Humans | StepShot |
|---|---|---|
| Price from | Free | Free |
| Free plan | Yes | Yes |
| Free trial | — | Yes |
| Open source | — | — |
| Windows | Yes | — |
| macOS | Yes | Yes |
| Linux | Yes | — |
| Self-hosted | Yes | — |
| Plans published | 1 | 3 |
| Spec score · Documentation Generators | 8.6 (#3) | 7.7 (#16) |
| Integrations | A `techdocs` template is described as optimized for TechDocs and MkDocs Material. | Cloud planning uses an OpenAI-compatible endpoint that the user supplies; the pricing page says users provide their own API and quota. |
| Offline use | The `js_offline` template bundles CSS and JavaScript resources so generated documentation can be used offline. | Capture, editing, and all three export formats work locally without an internet connection; optional cloud planning requires a connection. |
| Purpose | The project generates static HTML or Markdown pages documenting JSON Schema. | StepShot records real Mac workflows and uses AI to organize them into step-by-step tutorials, SOPs, and training documents. |
Plans
In their own words
JSON Schema for Humans
JSON Schema for Humans generates static HTML or Markdown documentation from valid JSON Schema files. Inputs can be JSON or YAML, supplied to its command-line interface as a file, directory, glob pattern, or comma-separated list; Python methods are also available. Multiple templates produce different outputs. The default JavaScript template provides expandable sections, tabs for conditional subschemas, and anchor links. The js_offline template bundles CSS and JavaScript for offline viewing. Markdown output can be published without an HTTP server and is rendered by GitHub when browsing code. A techdocs template is described as optimized for TechDocs and MkDocs Material. References can point within a schema, to local files, or to URLs, including circular references, and the project lists JSON Schema Draft-07 support. Safe mode escapes HTML tags in descriptions by default, while configuration can allow HTML. Property names and size, property dependencies, and media are listed as unsupported. The Apache-2.0 licensed package documents installation with `pip install json-schema-for-humans`.
StepShot
StepShot is a macOS app that turns recorded workflows into step-by-step tutorials, standard operating procedures, and training documents. It captures activity through action-driven capture or screen recording, using cursor pauses as an additional cue for splitting recordings into steps. Users can edit steps and annotations, then export to PDF, Markdown, or HTML. Capture, editing, and all three export formats work locally without an internet connection. Optional AI assistance can suggest improvements to titles, descriptions, and step order; users review suggestions individually before applying them. Cloud planning requires a connection and a user-supplied OpenAI-compatible endpoint, API, and quota. The free plan costs nothing, allows unlimited capture and editing, and exports only the first 10 steps in Markdown or HTML. Pro costs 269 CNY, paid once and adds unlimited steps, PDF export, branding, optional cloud planning, and activation on two devices. Team costs 899 CNY, paid once and adds five-device activation, shared brand presets, bulk licensing, centralized invoicing, and priority feedback handling. StepShot requires macOS 14 or later and supports Apple Silicon and Intel.