erbsland-ansi-for-sphinx

To embed ANSI terminal output in Sphinx documentation, enable the erbsland-ansi extension in conf.py and use the .. erbsland-ansi:: directive to insert preformatted ANSI blocks with automatic default CSS styling.

Dynamic terminal output renders inconsistently in Sphinx HTML builds because it contains live escape sequences. Normalizing captures into static ANSI blocks before embedding ensures consistent rendering across builds.

Yes, you can customize the styling of ANSI blocks in Sphinx by switching between default and themed styling using the :theme: option, or by applying custom CSS modifications to the extension's output.

Yes, you need to preprocess dynamic terminal captures into static ANSI blocks using a conversion step before embedding them, ensuring the erbsland-ansi directive renders the content reliably.

The best way to display static terminal snippets in Sphinx is using the erbsland-ansi directive, which enforces YAML frontmatter with name and description in SKILL.md and applies consistent styling to preformatted ANSI blocks.

Yes, the erbsland-ansi extension works without additional Sphinx dependencies. It operates as a standalone extension and directive, requiring only the standard Sphinx conf.py configuration to enable block embedding.