ANSI Rendering

ANSI rendering converts terminal output containing SGR escape sequences into colored, styled code blocks. Set the language to ansi and Kazari routes the code through a built-in parser instead of the external highlighter.

Basic usage

Set the language to ansi in the fence meta string:

1
```ansi title="test output"
2
...terminal output with escape sequences...
3
```

Pass ANSI-escaped strings via the Go API:

1
output := "\x1b[32m✔\x1b[0m Tests passed  \x1b[33m3 skipped\x1b[0m\n" +
2
    "\x1b[31m✘\x1b[0m \x1b[1mBuildError:\x1b[0m missing return statement"
3
4
html, err := engine.RenderWithMeta(output, `ansi title="test output"`)

→ The first line renders a green check mark followed by normal text and a yellow "3 skipped". The second line renders a red cross, then "BuildError:" in bold, then normal text.

All standard meta string options work on ANSI blocks: title=, frame=, showLineNumbers, {N-M} line markers, ins={}, del={}, focus={}, and inline markers. Because ansi is in the terminal language list, blocks auto-detect as terminal frame when WithFrameDetection is active.

1
html, err := engine.RenderWithMeta(output, `ansi title="build log" showLineNumbers {3}`)

→ A terminal-framed block titled "build log" with numbered lines and line 3 highlighted.

ANSI rendering bypasses the external highlighter entirely. It works with no highlighter configured on the engine.

Visual showcase

The block below demonstrates every color mode and font style that Kazari's ANSI parser supports.

1
Standard ANSI colors:
2
- Foreground:  Black Red Green Yellow Blue Magenta Cyan White
3
- Background:   Red   Green   Yellow   Blue   Magenta   Cyan   White 
4
5
Bright colors:
6
- Foreground:  Black Red Green Yellow Blue Magenta Cyan White
7
- Background:   Red   Green   Yellow   Blue   Magenta   Cyan   White 
8
9
8-bit colors (sample from 256-color palette):
10
- Foreground:  196 208 220 46 33 129
11
- Background:   196   208   220   46   33   129 
12
- Grayscale:   ██ ██ ██ ██ ██ ██ ██
13
14
24-bit true colors (full RGB):
15
- Foreground:  ForestGreen Orange RebeccaPurple DeepSkyBlue
16
- Background:   ForestGreen   Orange   RebeccaPurple   DeepSkyBlue 
17
18
Font styles:
19
- Default
20
- Bold
21
- Italic
22
- Underline
23
- Strikethrough
24
- Bold + Italic
25
- Bold + Underline + Green

Supported sequences

SGR state persists across lines within a single block, matching real terminal behavior. A color set on one line remains active on the next line unless explicitly reset. Malformed sequences (those containing non-digit, non-semicolon characters before m) pass through as literal text.

The following SGR codes are not supported: dim (2), blink (5/6), reverse video (7), and hidden/conceal (8). Non-SGR escape sequences (CSI cursor movement, OSC sequences) are also not handled.

Color modes

Standard 16 colors and bright colors (SGR 30-37, 40-47, 90-97, 100-107) resolve to CSS variable references (var(--kz-ansi-red), etc.) rather than hardcoded hex values. This allows retheming by overriding the --kz-ansi-* variables without touching the HTML.

256-color mode (SGR 38;5;N / 48;5;N) resolves differently by index range:

• Index 0-15: hardcoded hex values from the standard palette (not CSS variable references)
• Index 16-231: computed from a 6x6x6 RGB color cube
• Index 232-255: grayscale ramp from #080808 to #eeeeee

24-bit true-color (SGR 38;2;R;G;B / 48;2;R;G;B) produces direct #rrggbb hex values.

Standard 16 colors are themeable via the CSS variables. 256-color and 24-bit true-color values use literal hex and are not themeable through CSS variables.

CSS variables

The --kz-ansi-* variables define the standard 16-color palette. They are always emitted in engine.CSS() output regardless of configuration.

The defaults match the GNOME Terminal / VGA palette. Override any variable by redeclaring it on :root or a more specific selector in your stylesheet:

1
:root {
2
    --kz-ansi-red: #e06c75;
3
    --kz-ansi-green: #98c379;
4
}

See the CSS Variables reference for the complete list.

Edge cases

• ANSI rendering bypasses the external highlighter entirely. It works with no highlighter configured on the engine.
• The copy button copies raw text including escape codes, not the display text.
• Terminal comment stripping applies to ANSI blocks by default (terminal frame). Lines starting with # are stripped from the copy payload only, not from the display.
• ANSI escape sequences contain raw ESC bytes (0x1B) that are invisible in most text editors. The Go API uses \x1b[...m escape literals; the Goldmark extension processes raw ESC bytes embedded in Markdown fence blocks at build time.
• 256-color index 0-15 uses hardcoded hex values, not the --kz-ansi-* CSS variables. Only the standard 16 SGR colors (30-37, 40-47, 90-97, 100-107) use CSS variables.
• The --kz-ansi-* variables are theme-independent. They are emitted once in the static CSS block and do not change between light and dark themes.