GraphQL-Markdown · mdBook Demo
This site is generated from a GraphQL schema using graphql-markdown with the mdBook formatter preset.
What this demo shows
- Frontmatter is suppressed — mdBook renders
---as literal content, so the formatter returns an empty string instead. - Admonitions fall back to blockquote style (
> **NOTE**) since mdBook has no native admonition syntax. - Links keep the
.mdextension — mdBook resolves them natively. SUMMARY.mdwires all generated pages into the mdBook navigation.
Generation pipeline
npm run generateruns GraphQL-Markdown against the shared demo schema, loaded from its URL.- Pages are written to
src/graphql/using the mdBook formatter. src/SUMMARY.mdwires the generated pages into the mdBook navigation.mdbook serve/mdbook buildrenders the final site.
Key files
scripts/generate-docs.mjs— runs GraphQL-Markdown.src/SUMMARY.md— mdBook navigation, listing the generated pages.scripts/custom-mdbook-mdx.mjs— wraps the mdBook formatter preset.book.toml— mdBook configuration.