Markdown 渲染

Qwen Code 在 TUI 中直接渲染常见的 Markdown 结构，让模型回答更易于在终端内浏览。渲染器的设计原则是保持原始源码的可访问性，对于 Mermaid 图表和 LaTeX 数学公式等视觉块尤为如此。

渲染模式与原始模式

默认情况下，Markdown 以 render 模式显示。支持的块在可能的情况下渲染为可视化预览：

按 Alt/Option+M 可在当前会话的两种模式之间切换。在 macOS 上，终端必须将 Option 键作为 Meta 键发送才能使用此快捷键；否则 Option+M 会被识别为普通文本输入。

若要默认以 raw 模式启动 Qwen Code，请设置 ui.renderMode：


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

可接受的值为 "render" 和 "raw"。该快捷键仅更改当前会话的视图，不会修改配置文件。

围栏 mermaid 代码块在 render 模式下进行可视化渲染。TUI 采用分层策略：

Mermaid 图像渲染默认禁用，因为它需要外部渲染器和终端图像支持。通过以下方式启用：


QWEN_CODE_MERMAID_IMAGE_RENDERING=1 qwen

可选环境变量：

变量	说明
`QWEN_CODE_MERMAID_IMAGE_RENDERING=1`	启用外部 Mermaid 图像渲染。
`QWEN_CODE_DISABLE_MERMAID_IMAGES=1`	即使在其他地方已启用，也禁用 Mermaid 图像渲染。
`QWEN_CODE_MERMAID_IMAGE_PROTOCOL=kitty`	强制输出 Kitty 协议。适用于 Kitty 和 Ghostty 等终端。
`QWEN_CODE_MERMAID_IMAGE_PROTOCOL=iterm2`	请求 iTerm2 内联图像。交互式 TUI 渲染回退到文本/ANSI。
`QWEN_CODE_MERMAID_IMAGE_PROTOCOL=off`	禁用终端图像协议，允许文本或 `chafa` 回退。
`QWEN_CODE_MERMAID_MMD_CLI=/path/to/mmdc`	使用指定的 Mermaid CLI 可执行文件。
`QWEN_CODE_MERMAID_ALLOW_NPX=1`	当未安装 `mmdc` 时，允许 Qwen Code 运行 `npx @mermaid-js/mermaid-cli`。
`QWEN_CODE_MERMAID_ALLOW_LOCAL_RENDERERS=1`	允许使用 `node_modules/.bin` 下的项目本地渲染器二进制文件。
`QWEN_CODE_MERMAID_RENDER_WIDTH=1200`	覆盖 PNG 渲染宽度。
`QWEN_CODE_MERMAID_RENDER_TIMEOUT_MS=10000`	覆盖外部渲染超时时间，上限为 60000 ms。
`QWEN_CODE_MERMAID_CELL_ASPECT_RATIO=0.5`	调整图像行适配以匹配终端字体单元格几何形状。

首次图像渲染可能较慢，尤其是当 npx 需要解析或下载 Mermaid CLI 时。在流式传输过程中，Qwen Code 显示有界文本预览，仅在模型响应完成后才尝试图像渲染。

每个渲染后的 Mermaid 块都包含如下源码提示：


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

使用以下命令从最后一条 AI 回复中复制 Mermaid 源码：

/copy code 1 计数所有围栏代码块，而不仅限于 Mermaid 块。当你想要渲染标题中显示的 Mermaid 特定序号时，请使用 /copy mermaid N。

Qwen Code 支持在终端中进行基本的行内和块级 LaTeX 渲染：


Inline math: $x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$
 
$$
\sum_{n=1}^{\infty} 1/n^2 = \pi^2/6
$$

渲染器专注于常见符号和可读的终端输出。它不是完整的 TeX 引擎；矩阵、对齐方程和大型嵌套表达式等复杂布局可能会被简化。

行内 $...$ 表达式每行刻意限制在 1024 个字符，以防止格式错误或超大生成 Markdown 导致终端渲染卡顿。超长公式仍以源文本形式可见，依然可以从 raw 模式或原始回复中复制。

使用以下命令从最后一条 AI 回复中复制 LaTeX 源码：

行内 LaTeX 在渲染文本中不显示逐表达式的复制提示，以避免正文显得嘈杂。如需就地查看行内源码，请使用 Alt/Option+M 切换到 raw 模式；在 macOS 上，这需要终端支持 Option 键作为 Meta 键输入。

/copy code 命令从最后一条 AI Markdown 回复中读取围栏代码块：

默认情况下，/copy 以最近的 AI 消息为目标。在命令前加上正整数可从倒数第 N 条 AI 消息中复制——当最新回复是低信息量的内容（例如 TODO 更新），而实质性输出在前一两轮时，这非常方便。

/copy 1 等同于 /copy。如果 N 超过会话中 AI 消息的总数，/copy 会报告实际数量而不复制任何内容。不带前导整数时，/copy code python 2 等子选择器保持其原有含义（最后一条消息中的第 2 个 python 块）。