# mbterm
`mbterm` renders `mbdown` documents as safe ANSI terminal text. Display math is
laid out with terminal-native Unicode glyphs, with a syntax-highlighted `tex`
source fallback for invalid or over-wide formulas. It provides
Unicode-aware wrapping and layout, named semantic styles, restricted BBCode,
language-aware fenced-code highlighting, and OSC 8 hyperlinks while removing
input terminal control sequences. Its
default semantic styles use the Catppuccin Mocha palette and can be overridden
with a `Theme`.
The package also installs the `mbterm` command:
```bash
cargo install mbterm
mbterm document.md
mbterm --corners rounded document.mb
mbterm --front-matter document.md
printf '# Hello\n\n[green]Ready[/green]\n' | mbterm
```
Initial YAML/TOML front matter is hidden by default. Library users can opt in
with `Renderer::with_front_matter(true)`; the command-line equivalent is
`--front-matter`.
Library users can select the same presentation through
`Theme::new().with_corner_style(CornerStyle::Rounded)`. It applies to bordered
boxes, fenced code frames, and table outer corners.
See the [MBDown 0.1 Language Specification](https://github.com/FrostMiKu/mbdown/blob/main/docs/language-specification.md)
for the core language and the [workspace README](https://github.com/FrostMiKu/mbdown)
for terminal theme examples.