Markdown Rendering

Qwen Code renders common Markdown structures directly in the TUI so model answers are easier to scan without leaving the terminal. The renderer is designed to keep the original source reachable, especially for visual blocks such as Mermaid diagrams and LaTeX math.

Render and Raw Modes

By default, Markdown is shown in render mode. Supported blocks render as visual previews where possible:

• Mermaid fenced code blocks
• Markdown tables
• task lists
• blockquotes
• inline and block LaTeX math
• fenced code blocks with syntax highlighting

Press Alt/Option+M to toggle the current session between modes. On macOS, the terminal must send Option as Meta for this shortcut; otherwise Option+M is treated as normal text input.

• render: show rich terminal previews for supported Markdown.
• raw: show source-oriented Markdown for visual blocks such as Mermaid, tables, and LaTeX.

To start Qwen Code in raw mode by default, set ui.renderMode:

{
  "ui": {
    "renderMode": "raw"
  }
}

Accepted values are "render" and "raw". The shortcut only changes the current session view; it does not rewrite your settings file.

Mermaid

Fenced mermaid code blocks render visually in render mode. The TUI uses a layered strategy:

1. If enabled and supported, Qwen Code asks Mermaid CLI (mmdc) to render the diagram to a PNG and sends it to the terminal image protocol.
2. If terminal images are unavailable but chafa is installed, the same PNG can be converted to ANSI block graphics.
3. Otherwise, Qwen Code falls back to a terminal wireframe or compact text preview.
4. If a Mermaid diagram type cannot be previewed, Qwen Code shows the original fenced source instead of hiding it behind a placeholder.

Mermaid image rendering is disabled by default because it requires external renderers and terminal image support. Enable it with:

QWEN_CODE_MERMAID_IMAGE_RENDERING=1 qwen

Optional environment variables:

The first image render can be slow, especially when npx needs to resolve or download Mermaid CLI. During streaming, Qwen Code shows a bounded text preview and attempts image rendering only after the model response is complete.

Mermaid Source Copy

Every rendered Mermaid block includes a source hint such as:

Mermaid flowchart (TD) · source: /copy mermaid 1

Use these commands to copy Mermaid source from the last AI response:

/copy code 1 counts all fenced code blocks, not only Mermaid blocks. Use /copy mermaid N when you want the Mermaid-specific sequence shown in the rendered title.

LaTeX Math

Qwen Code supports basic inline and block LaTeX rendering in the terminal:

Inline math: $x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$

$$
\sum_{n=1}^{\infty} 1/n^2 = \pi^2/6
$$

The renderer focuses on common symbols and readable terminal output. It is not a full TeX engine; complex layouts such as matrices, aligned equations, and large nested expressions may be simplified.

Inline $...$ expressions are intentionally bounded to 1024 characters per line so malformed or very large generated Markdown cannot stall terminal rendering. Longer formulas remain visible as source text and can still be copied from raw mode or the original response.

LaTeX Source Copy

Use these commands to copy LaTeX source from the last AI response:

Inline LaTeX does not show a per-expression copy hint in rendered text to avoid making prose noisy. Switch to raw mode with Alt/Option+M when you want to inspect inline source in place; on macOS this requires Option-as-Meta terminal input.

General Code Copy

The /copy code command reads fenced code blocks from the last AI Markdown response:

Current Limits

• Mermaid image rendering depends on Mermaid CLI plus terminal image support.
• Async iTerm2 inline image placement is disabled in the TUI because the protocol is cursor-position bound; use Kitty/Ghostty or ANSI fallback for interactive image previews.
• Wireframe Mermaid rendering is a readable terminal preview, not a full Mermaid layout engine.
• Raw mode is global for rendered Markdown blocks; it is not a per-block toggle.
• LaTeX rendering covers common symbols and expressions, not full TeX layout.
• Source copy commands operate on the last AI response.