Image display requirements

terminal

Images are rendered using the Kitty graphics protocol. The terminal emulator must support this protocol for images to be displayed.

Terminals known to support it include:

• Kitty
• WezTerm
• Ghostty
• iTerm2 3.6 and later

In unsupported terminals, images are replaced with their alt text.

Mermaid diagrams

Rendering Mermaid fenced code blocks requires mmdc (Mermaid CLI) to be installed and available in PATH.

npm install -g @mermaid-js/mermaid-cli

If mmdc is not found, Mermaid blocks are displayed as plain code blocks.

Graphviz diagrams

Rendering fenced code blocks tagged dot or graphviz requires dot (from the Graphviz suite) to be installed and available in PATH.

# macOS
brew install graphviz

# Debian / Ubuntu
sudo apt install graphviz

# Fedora
sudo dnf install graphviz

If dot is not found, Graphviz blocks are displayed as plain code blocks.