Skip to content

json-schema2salad

json-schema2salad translates JSON Schema documents into a practical subset of Schema Salad, the schema language used by the Common Workflow Language ecosystem.

The documentation is organized with the Diataxis approach:

  • Tutorials help you learn the tool by making one successful conversion.
  • How-to guides help you complete specific conversion tasks.
  • Reference gives exact command-line and conversion-rule details.
  • Explanation describes the conversion model, trade-offs, and current scope.

Development status

This tool is still being refined. Unsupported or lossy cases are preserved as far as possible, and the converter records warnings when it must fall back to a broader Any type. The current behavior should be treated as an implemented conversion policy, not yet as a full JSON Schema to Schema Salad specification.

Start here

If you are new to the tool, begin with Convert your first JSON Schema.

If you already know what you need to do, go straight to Convert JSON Schema documents.

If you need exact behavior, use the command line reference and conversion rules reference.