JSON Schema → Human-Readable Docs

Generate readable documentation from a JSON Schema for your LLM tools.

Ad placeholder (leaderboard)

Turn a JSON Schema into docs people can actually read

A JSON Schema is precise but not pleasant to read, and for LLM tool definitions the parameter descriptions double as the contract the model reads to decide how to call your tool. This generator converts a schema — including OpenAI and Anthropic tool wrappers — into a clean Markdown reference table with types, required flags, allowed values, and defaults.

How it works

You paste a JSON Schema. If it is wrapped in a tool definition (OpenAI’s function.parameters or Anthropic’s input_schema), the tool unwraps it automatically. It then walks the properties map, recursing into nested objects and array item schemas, and emits a Markdown table. Each row shows the parameter name (with a dotted path for nested fields), its type, whether it is required, any enum values or default, and the description. Invalid JSON is reported with the parse error so you can fix it fast.

Tips for better tool docs

  • Write a description for every parameter. The model uses these to decide argument values; a blank description is a common cause of wrong tool calls.
  • Use enum for closed sets. Documenting allowed values explicitly beats a free-text string the model has to guess at.
  • Mark required fields accurately. The generated table surfaces gaps where a field is used but not listed in required.
  • Regenerate the docs whenever the schema changes so your reference never drifts from the actual contract.
Ad placeholder (rectangle)