Skip to main content

mkdocs

MkDocs formatter for GraphQL documentation output.

Produces Markdown compatible with MkDocs admonitions, HTML details blocks, and visible page headings.

__default​

const __default: object;

Defined in: mkdocs/index.ts:31

Type Declaration​

formatMDXBullet​

formatMDXBullet: typeof formatMDXBullet;
formatMDXLink: typeof formatMDXLink;
formatMDXPermalink: typeof formatMDXPermalink;

afterRenderTypeEntitiesHook​

const afterRenderTypeEntitiesHook: RenderTypeEntitiesHook;

Defined in: mkdocs/index.ts:135

Lifecycle hook that rewrites generated absolute GraphQL-Markdown links into page-relative .md links compatible with MkDocs validation.

Param​

event

Hook payload containing the current file path and renderer output context

mdxExtension​

const mdxExtension: ".md";

Defined in: mkdocs/index.ts:128

File extension used for generated pages — MkDocs uses standard Markdown (.md) files.

createMDXFormatter()​

function createMDXFormatter(_meta?): Formatter;

Defined in: mkdocs/index.ts:148

Creates an MkDocs Material formatter.

Parameters​

_meta?​

Maybe<MetaInfo>

Unused metadata parameter

Returns​

Formatter

A complete Formatter implementation for MkDocs Material output

formatMDXAdmonition()​

function formatMDXAdmonition(admonition, _meta): MDXString;

Defined in: mkdocs/index.ts:70

Formats an admonition using MkDocs Material !!! block syntax. Content is indented by 4 spaces as required by the spec.

Parameters​

admonition​

AdmonitionType

Admonition data with text, title, and type

_meta​

Maybe<MetaInfo>

Unused metadata parameter

Returns​

MDXString

Formatted admonition string

formatMDXBadge()​

function formatMDXBadge(badge): MDXString;

Defined in: mkdocs/index.ts:59

Formats a badge as an inline HTML mark element.

Parameters​

badge​

Badge

Badge data containing text and optional classname

Returns​

MDXString

Formatted badge string

formatMDXDetails()​

function formatMDXDetails(option): MDXString;

Defined in: mkdocs/index.ts:84

Formats a collapsible block as an HTML <details> element.

Parameters​

option​

CollapsibleOption

Configuration for open/close label text

Returns​

MDXString

Formatted collapsible string

formatMDXFrontmatter()​

function formatMDXFrontmatter(_props, formatted): MDXString;

Defined in: mkdocs/index.ts:97

Formats page title as a visible H1 heading.

Parameters​

_props​

Maybe<FrontMatterOptions>

Front matter options (unused)

formatted​

Maybe<string[]>

Pre-formatted front matter lines

Returns​

MDXString

Visible heading string, or empty string if no title is available

formatMDXNameEntity()​

function formatMDXNameEntity(name, parentType?): MDXString;

Defined in: mkdocs/index.ts:110

Formats a named entity as a backtick code span.

Parameters​

name​

string

Entity name

parentType?​

Maybe<string>

Optional parent type name for qualified references

Returns​

MDXString

Formatted entity reference string

function formatMDXSpecifiedByLink(url): MDXString;

Defined in: mkdocs/index.ts:123

Formats a "specified by" link as a standard Markdown link.

Parameters​

url​

string

URL to the specification

Returns​

MDXString

Formatted specification link string