Syntax Highlighting

Kazari renders fenced code blocks with language-aware syntax coloring. A pluggable highlighter (Nuri or Chroma) tokenizes the source code, and Kazari handles all presentation: frames, line numbers, markers, copy buttons, and theme switching.

Basic usage

Set the language identifier as the first word after the opening backticks:

1
```go
2
func main() {
3
    fmt.Println("Hello, world!")
4
}
5
```

The language identifier controls both syntax coloring and frame auto-detection. Additional per-block options (title, line numbers, markers) follow the language in the same line. See Meta String Syntax for the full list.

1
```go title="main.go" showLineNumbers {3}
2
package main
3
4
import "fmt"
5
6
func main() {
7
    fmt.Println("Hello, world!")
8
}
9
```

Pass code through the Go API with the same options:

1
html, err := engine.Render(code, kazari.Options{
2
    Lang: "go",
3
})

Or use a meta string directly:

1
html, err := engine.RenderWithMeta(code, `go title="main.go" showLineNumbers {3}`)

Supported languages

Kazari delegates tokenization to whichever Highlighter is configured on the engine. Two adapters are provided:

Nuri uses the same TextMate grammars as Shiki. See the full list of supported languages and themes on GitHub. See each adapter page for setup instructions and configuration.

Language aliases

Map shorthand names to canonical language identifiers so code fences resolve correctly. Aliases are case-insensitive.

1
languageAliases:
2
  ts: typescript
3
  js: javascript
4
  py: python
5
  rs: rust

1
engine := kazari.New(
2
    kazari.WithHighlighter(hl),
3
    kazari.WithLanguageAliases(map[string]string{
4
        "ts": "typescript",
5
        "js": "javascript",
6
    }),
7
)

When a code block uses ts as its language, the engine resolves it to typescript before passing it to the highlighter. See Configuration Options and File-Based Config for the full option reference.

Unknown languages

When the language identifier is not recognized by the configured highlighter, Kazari falls back to plaintext rendering (no coloring) and emits a warning through the engine's warning handler. The block still renders with all presentation features (frame, copy button, line numbers) intact.

Terminal output

For rendering terminal output with ANSI escape sequences, set the language to ansi. Kazari bypasses the external highlighter and parses SGR escape codes directly into colored, styled tokens. See ANSI Rendering for supported sequences, color modes, and the visual showcase.