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 graphqlAdd to your docusaurus.config.js:
module.exports = {
plugins: ["@graphql-markdown/docusaurus"],
};Run the generation command:
npx docusaurus graphql-to-docnpx gqlmd graphql-to-doc --schema ./schema.graphql --output ./docsFor programmatic usage, you can use the CLI package:
import { runGraphQLMarkdown } from '@graphql-markdown/cli';
const config = {
schema: './schema.graphql',
rootPath: './docs',
};
await runGraphQLMarkdown(config);See API documentation and our Framework Integration page for more details.
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!
