Skip to main content

Introduction

The @graphql-markdown/docusaurus package extends the Docusaurus CLI with commands for generating MDX using a GraphQL schema as the source. It simplifies the process of creating and maintaining GraphQL API documentation by automatically generating well-structured documentation from your schema.

Why GraphQL Markdown?​

Managing API documentation can be time-consuming and prone to becoming outdated. This package solves these challenges by:

  • Automatically generating documentation from your schema
  • Keeping documentation in sync with your API
  • Providing a consistent documentation structure
  • Integrating seamlessly with Docusaurus

Features​

  • Easy set up and customizable
  • Full relations information between types
    • Visual representation of type relationships
    • Complete type hierarchy documentation
  • MDX generated are fully compatible with plugin-content-docs
    • Supports all Docusaurus features
    • Customizable with MDX components
  • Use any schema loader compatible with @graphql-tools/load
    • Support for local schema files
    • Support for remote GraphQL endpoints
  • Group types into categories using directives
    • Organize types logically
    • Create custom navigation structure
  • Support of GraphQL config
    • Integration with existing GraphQL setups
    • Consistent configuration across tools

Quick Install​

npm install @graphql-markdown/cli