Documentation

    Hosted installer: at launch

    Rich fences

    All reference topics

    Rich fences

    The fence tags:

    TagBlock
    chartA chart drawn from block-local data.
    tableA table drawn from block-local data.
    metricA single large number with its caption and change.
    calloutA highlighted note with a direction.
    imageAn image from the report folder or a credited Unsplash photo.
    embedAn iframe of an allowed https host.
    scrollyOne image that stays in view beside narrative steps, each naming the state the figure takes.
    audioAn audio player.
    videoA video player.

    Rich block bodies must be YAML mappings. Fence recognition follows CommonMark, including longer fences and quoted code examples; diagnostic lines include the frontmatter.

    An unknown key in a rich block, at any depth, is a block.unknown-key warning with its line and the nearest known key, and it is dropped before rendering, so it reaches neither the HTML nor a payload. A known key with a value of the wrong type, enum or range, and a missing required field, is a block.schema error: the fence stays visible as code and publishing refuses the report. A required title (chart, audio, video) must not be empty; an image’s alt may be "" to mark it decorative. The same walker checks the frontmatter, where an unknown key warns and stays in the metadata with no effect.

    Was this page useful? Suggest an edit