/graphql-markdown

Flexible GraphQL Documentation Generator (Markdown)

Primary LanguageTypeScriptMIT LicenseMIT

GraphQL-Markdown

Flexible documentation for GraphQL schemas

NPM Last Update GitHub License Buy us a tree Commitizen friendly

GraphQL-Markdown

Generate Markdown documentation from GraphQL schemas for static site generators.

Installation

Choose your preferred package based on your static site generator:

# For Docusaurus
npm install @graphql-markdown/docusaurus graphql

# For other static site generators
npm install @graphql-markdown/cli graphql

Usage

Docusaurus Plugin

Add to your docusaurus.config.js:

module.exports = {
  plugins: ["@graphql-markdown/docusaurus"],
};

Run the generation command:

npx docusaurus graphql-to-doc

CLI Usage

npx gqlmd graphql-to-doc --schema ./schema.graphql --output ./docs

Configuration

See documentation configuration page.

Troubleshooting

See documentation troubleshooting page.

License

GraphQL-Markdown packages are 100% free and open-source, under the MIT license.

This package is Treeware. If you use it in production, then we ask that you buy the world a tree to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.

Contributions

Contributions, issues and feature requests are very welcome. If you are using this package and fixed a bug for yourself, please consider submitting a PR!