Configuration
Payload Markdown separates configuration into clear namespaces:
1payloadMarkdown({2 code: {},3 icons: {},4 themes: {},5 config: {},6 collections: {7 posts: {8 code: {},9 themes: {},10 config: {},11 },12 },13})Use code for Shiki and fenced code behavior, icons for local SVG icon packs, themes for directive theme registries, and config for Markdown wrapper presentation.
Plugin Config
The full public config shape, icon packs, collection install options, and preferred namespaces.
Scoping
How defaults merge from plugin config through collection config and direct renderer props.
Code Blocks
Shiki themes, language loading, enhanced rendering, line numbers, and full-bleed code.
Styling
Tailwind setup, wrapper classes, typography variants, and deprecated class aliases.
Directive Themes
Named themes, built-in theme groups, parent-child defaults, and stable output hooks.
API Reference
Option names, exports, directive names, and renderer props in one place.
Do not put directive themes under config, and prefer top-level or collection-level code over legacy config.options.