Markdown extensions

The catalog of markdown-type extensions. They add markdown constructs to CommonMark: callouts, galleries, grids, video. Each is wired up through env.markdown.

How it works

Directive-based constructs use generic directives (:::name, ::name, :name). An extension maps a directive straight to a block node via env.markdown.directive(...); for other syntax and arbitrary transforms there is the low-level env.markdown.use(...). The full contract is in the markdown extension guide.

See the guide for an explicit MDAST conversion example. node.children is MDAST, not BEMTree: do not assign it directly to content.

A markdown construct almost always comes paired with a block extension that ships the block it expands into. That is why one package often combines a markdown extension and a block extension.

Registry

Markdown extensions:

• nuckty-ext-markdown-typography-ru — Russian typography: a non-breaking space before a dash. Adds no block — it only adjusts text.
• nuckty-ext-markdown-video — video embedding @[provider](id) (YouTube/RuTube/VK). Ships no block — the plugin builds the player markup.

Markdown constructs that come paired with a block live in block extensions:

• Gallery (:::gallery) — in the nuckty-ext-block-gallery package.
• Grid (:::grid) — in the nuckty-ext-block-grid package.
• Callout (:::callout) — a candidate for a separate package.