Generate nice docs for your GraphQL schema right in your GitHub repository.
$ npm install graphql-markdown --save-devSee an example generated from the GraphBrainz schema.
Installing the package adds a graphql-markdown script. Point it at a schema
and the output will be written to stdout.
The schema may be retrieved from a GraphQL endpoint:
$ graphql-markdown https://your-server.com/graphql > schema.md…or a module exporting an instance of GraphQLSchema:
$ graphql-markdown ./path/to/schema.js > schema.md…or a file containing GraphQL syntax:
$ graphql-markdown ./path/to/schema.graphql > schema.md…or a file containing the JSON output of an introspection query:
$ graphql-markdown ./path/to/schema.json > schema.md$ graphql-markdown --help
Usage: graphql-markdown [options] <schema>
Output a Markdown document with rendered descriptions and links between types.
The schema may be specified as:
- a URL to the GraphQL endpoint (the introspection query will be run)
- a GraphQL document containing the schema (.graphql or .gql)
- a JSON document containing the schema (as returned by the introspection query)
- an importable module with the schema as its default export (either an instance
of GraphQLSchema or a JSON object)
Options:
--title <string> Change the document title (default: 'Schema Types')
--prologue <string> Include custom Markdown at the beginning of the document
--epilogue <string> Include custom Markdown at the end of the document
--require <module> If importing the schema from a module, require the specified
module first (useful for e.g. babel-register)
--version Print version and exitOutput is optimized for display on GitHub, using GitHub Flavored Markdown. Due to the complexity of the tables in the generated document, much of the table output is raw HTML (as allowed by Markdown).