Command

bengal.debug.sandbox

Test shortcodes/directives in isolation.

Renders directives without building the entire site, useful for
testing and debugging directive syntax before adding to content.

Usage

bengal.debug.sandbox [OPTIONS]

Options

Option Type Description
--file PATH

Read content from file

--help-directive TEXT

Get detailed help for a directive

--list-directives flag BOOLEAN

List all available directives

--format CHOICE

Output format

Default:console
--traceback CHOICE

Traceback verbosity

--validate-only flag BOOLEAN

Only validate syntax, don't render

Arguments

Argument Type Description
content TEXT

Examples

            bengal debug sandbox '```{note}
This is a note.
```'
            bengal debug sandbox --file test-directive.md
            bengal debug sandbox --list-directives
            bengal debug sandbox --help-directive tabs
            bengal debug sandbox --validate-only '```{note}
Test
```'