@graphql-markdown/docusaurus - npm Package Versions

1.30.2 - 2025-08-27

🧹 This release cleans up few bugs:

• front matter entities declared in Docusaurus plugin config not propagated to generated MDX files (#2341)
• GraphQL code formatting issue for operations using default values with input object fields (#2356)

What's Changed

• fix(deps): update graphql-tools monorepo by @renovate[bot] in #2287
• 📦 npm(deps): Bump @graphql-tools/load from 8.1.1 to 8.1.2 by @dependabot[bot] in #2300
• 📦 npm(deps): Bump @graphql-tools/graphql-file-loader from 8.0.21 to 8.0.22 by @dependabot[bot] in #2302
• chore(deps): update dependency @graphql-tools/graphql-file-loader to v8.1.0 by @renovate[bot] in #2353
• :bug: fix issue with default values for object type fields by @edno in #2356
• :bug: fix overwritten docOptions (Docusaurus plugin config) by @edno in #2357

Full Changelog: https://github.com/graphql-markdown/graphql-markdown/compare/1.30.1...1.30.2

[Changes][1.30.2]

<a id="1.30.1"></a>

1.30.0 - 2025-06-25

🌟 This release improves prettier support config file and now uses MDX parser instead of Markdown, reported in #2236 by @PaulRBerg. It also comes with a new configuration option for homepage that can now be set to false to disable its generation, reported in #2234 by @PaulRBerg.

What's Changed

• 🗒️ remove id: schema reference from homepage.md by @edno in #2245
• :sparkles: add support for disabling homepage by @edno in #2246
• :bug: fix prettier support for mdx with config by @edno in #2255
• :test_tube: fix utils.prettier tests by @edno in #2258

Full Changelog: https://github.com/graphql-markdown/graphql-markdown/compare/1.29.1...1.30.0

[Changes][1.30.0]

<a id="1.29.1"></a>

1.29.1 - 2025-06-15

🐛 This release adds better support of special characters (e.g. _) in entity names, fixing issues like #2213 reported by @PaulRBerg.

📄 The documentation has also got its share of fixes, thanks to @PaulRBerg reports.

What's Changed

• :memo: more doc update in #2065
• :bug: fix mdx compilation error when underscore used with entity name in #2215
• :memo: fix pretty param in config docs in #2220
• :memo: fix incorrect use of customDirective in example in #2221
• :memo: add troubleshooting info linked to #2213 in #2216

Full Changelog: https://github.com/graphql-markdown/graphql-markdown/compare/1.29.0...1.29.1

[Changes][1.29.1]

<a id="1.29.0"></a>

1.29.0 - 2025-03-21

✨ One step closer to a stable version of the @graphql-markdown/cli package. More Docusaurus specific MDX features have been moved from the base packages to @graphql-markdown/docusaurus/mdx 👾👾👾

Demos of @graphql-markdown/cli@0.3.0 with other static documentation frameworks:

| <img align="center" width="20" height="20" alt="GitHub" src="https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png">graphql-markdown/demo-astro-starlight | <img align="center" width="20" height="20" alt="GitHub" src="https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png">graphql-markdown/demo-nextjs-fumadocs | | --- | --- | | <p align="center">Astro Starlight with a custom MDX formatting module.</p> | <p align="center">Next.js Fumadocs with a custom MDX formatting module.</p> | | | |

What's Changed

• ✨ extract more docusaurus specifics by @edno in #2035
• :bug: fix badge classname linked to docusaurus css by @edno in #2038
• 🐛 fix docusaurus category file not exposed by @edno in #2039

Full Changelog: https://github.com/graphql-markdown/graphql-markdown/compare/1.28.0...1.29.0

[Changes][1.29.0]

<a id="1.28.0"></a>

1.28.0 - 2025-03-16

✨ The framework independent package cli is slowly maturing. It is now the backbone of the docusaurus package. From now, it should be possible to create customized MDX formatter for Next.js, Gatsby, Astro... using the undocumented setting mdxParser. For more information and examples, see the docusaurus package's source code.

🔧 This release also comes with a tiny new CLI flag --config that will print the processed configuration into a JSON format. This can be handy while debugging some of the customization, especially when mixing CLI and GraphQL Config settings.

What's Changed

• 📦 fix(deps): update graphql-tools monorepo by @renovate in #1976
• :sparkle: docusaurus plugin extends cli package by @edno in #1982
• 📦 fix(deps): update graphql-tools monorepo by @renovate in #1989
• 📄 Fix showcase Saleor typo by @krzysztofzuraw in #1991
• 📦 fix(deps): update graphql-tools monorepo by @renovate in #1999
• ✨ isolate mdx by @edno in #2000
• 📦 fix(deps): update graphql-tools monorepo by @renovate in #2012
• 📦 fix(deps): update graphql-tools monorepo by @renovate in #2014
• :sparkles: add cli support for external mdx package by @edno in #2017
• :construction_worker: fix packages api docs generation by @edno in #2021
• :wrench: fix api doc generation issue by @edno in #2025
• 🐛 fix docusaurus mdx external module by @edno in #2023

New Contributors

• @krzysztofzuraw made their first contribution in #1991

Full Changelog: https://github.com/graphql-markdown/graphql-markdown/compare/1.27.0...1.28.8

[Changes][1.28.0]

<a id="1.27.0"></a>

1.27.0 - 2025-02-16

🚀 This release introduces a new NodeJS command line package @graphql-markdown/cli allowing generation of Markdown files without Docusaurus dependencies. This is still an early release and it is not yet documented, but you can experiment with it and give your feedback on this new package when used with other static site generators - note that you'll need MDX support.

• Install npm install @graphql-markdown/cli
• Usage npx gqlmd graphql-to-doc

ℹ️ The cli package works similarly to the Docusaurus plugin, but it relies on a GraphQL config file for the settings. You can find examples of settings in the test folder of the package.

⚠️ BREAKING CHANGES - All previously deprecated settings have been removed:

• docOptions.pagination | --noPagination (deprecated in release 1.22.0)
• docOptions.toc | --noToc (deprecated in release 1.22.0)
• printTypeOptions.useApiGroup | --noApiGroup (deprecated in release 1.26.0)

What's Changed

• ✨ generic cli package by @edno in #1959
• :sparkles: move docusaurus\utils from printer to docusaurus plugin by @edno in #1962
• :sparkles: remove deprecated settings by @edno in #1964

Full Changelog: https://github.com/graphql-markdown/graphql-markdown/compare/1.26.4...1.27.0

[Changes][1.27.0]

<a id="1.26.4"></a>

1.26.4 - 2024-12-22

🐛 This release adds fixes for printTypeOptions parameters hierarchy and exampleSection.

What's Changed

• ♻️ remove circular dependencies in #1820
• :bug: fix error when hierarchy is defined in CLI but validation failed against default value in #1884
• 🐛 fix error with example option when a schema contains recursive types in #1887, reported by @TurkeyMcGuyver in #1883

Full Changelog: https://github.com/graphql-markdown/graphql-markdown/compare/1.26.3...1.26.4

[Changes][1.26.4]

<a id="1.26.3"></a>

1.26.3 - 2024-11-14

🐛 This releases fixes graphql-markdown logs not being reported with Docusaurus 3.

What's Changed

• :bug: fix dynamic import for logger packages by @edno in #1802
• 📦 fix(deps): update graphql-tools monorepo by @renovate in #1801
• 📦 fix(deps): update dependency @graphql-inspector/core to v6.2.0 by @renovate in #1799

Full Changelog: https://github.com/graphql-markdown/graphql-markdown/compare/1.26.2...1.26.3

[Changes][1.26.3]

<a id="1.26.2"></a>