Generate Markdown documentation from GraphQL schemas for static site generators.

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

Add to your docusaurus.config.js:

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

Run the generation command:

npx docusaurus graphql-to-doc

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

See documentation configuration page.

See documentation troubleshooting page.

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, issues and feature requests are very welcome. If you are using this package and fixed a bug for yourself, please consider submitting a PR!