Renderização de Markdown

O Qwen Code renderiza estruturas comuns de Markdown diretamente na TUI, para que as respostas do modelo sejam mais fáceis de escanear sem sair do terminal. O renderizador foi projetado para manter a fonte original acessível, especialmente para blocos visuais, como diagramas Mermaid e LaTeX math.

Modos Render e Raw

Por padrão, o Markdown é exibido no modo render. Blocos suportados são renderizados como pré-visualizações visuais quando possível:

• Blocos de código cercados do Mermaid
• Tabelas Markdown
• Listas de tarefas
• Blockquotes
• LaTeX math inline e em bloco
• Blocos de código cercados com destaque de sintaxe

Pressione Alt/Option+M para alternar o modo da sessão atual. No macOS, o terminal deve enviar Option como Meta para este atalho; caso contrário, Option+M é tratado como entrada de texto normal.

• render: mostra pré-visualizações ricas no terminal para Markdown suportado.
• raw: mostra Markdown orientado à fonte para blocos visuais como Mermaid, tabelas e LaTeX.

Para iniciar o Qwen Code no modo raw por padrão, defina ui.renderMode:

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

Os valores aceitos são "render" e "raw". O atalho altera apenas a visualização da sessão atual; ele não reescreve seu arquivo de configuração.

Mermaid

Blocos de código cercados do tipo mermaid são renderizados visualmente no modo render. A TUI usa uma estratégia em camadas:

1. Se habilitado e suportado, o Qwen Code solicita ao Mermaid CLI (mmdc) que renderize o diagrama como PNG e o envia ao protocolo de imagem do terminal.
2. Se as imagens do terminal não estiverem disponíveis, mas chafa estiver instalado, o mesmo PNG pode ser convertido em gráficos de bloco ANSI.
3. Caso contrário, o Qwen Code recorre a um wireframe de terminal ou prévia de texto compacta.
4. Se um tipo de diagrama Mermaid não puder ser pré-visualizado, o Qwen Code mostra o código cercado original em vez de escondê-lo atrás de um placeholder.

A renderização de imagem Mermaid é desabilitada por padrão porque requer renderizadores externos e suporte a imagens no terminal. Ative-a com:

QWEN_CODE_MERMAID_IMAGE_RENDERING=1 qwen

Variáveis de ambiente opcionais:

A primeira renderização de imagem pode ser lenta, especialmente quando o npx precisa resolver ou baixar o Mermaid CLI. Durante o streaming, o Qwen Code mostra uma prévia de texto limitada e tenta a renderização de imagem apenas após a resposta do modelo estar completa.

Cópia da Fonte Mermaid

Cada bloco Mermaid renderizado inclui uma dica de fonte como:

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

Use estes comandos para copiar a fonte Mermaid da última resposta da IA:

/copy code 1 conta todos os blocos de código cercados, não apenas os Mermaid. Use /copy mermaid N quando quiser a sequência específica do Mermaid mostrada no título renderizado.

LaTeX Math

O Qwen Code suporta renderização básica de LaTeX inline e em bloco no terminal:

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

O renderizador foca em símbolos comuns e saída legível no terminal. Ele não é um motor TeX completo; layouts complexos como matrizes, equações alinhadas e expressões grandes aninhadas podem ser simplificados.

Expressões inline $...$ são intencionalmente limitadas a 1024 caracteres por linha para que Markdown malformado ou muito grande não possa travar a renderização do terminal. Fórmulas mais longas permanecem visíveis como texto fonte e podem ser copiadas do modo raw ou da resposta original.

Cópia do código-fonte LaTeX

Use estes comandos para copiar o código-fonte LaTeX da última resposta da IA:

LaTeX inline não exibe uma dica de cópia por expressão no texto renderizado para evitar poluir a prosa. Mude para modo raw com Alt/Option+M quando quiser inspecionar o código-fonte inline no lugar; no macOS, isso requer entrada de terminal Option-como-Meta.

Cópia Geral de Código

O comando /copy code lê blocos de código cercados da última resposta em Markdown da IA:

Selecionando uma Mensagem Anterior da IA

Por padrão, /copy tem como alvo a mensagem mais recente da IA. Prefixe o comando com um número inteiro positivo para copiar da N-ésima última mensagem da IA — útil quando a resposta mais recente é algo de baixo sinal (ex.: uma atualização de TODO) e a saída substancial está uma ou duas rodadas atrás.

/copy 1 é equivalente a /copy. Se N exceder o número de mensagens da IA na sessão, /copy reporta a contagem real em vez de copiar algo. Sem um número inteiro inicial, sub-seletores como /copy code python 2 mantêm seu significado existente (o segundo bloco python na última mensagem).

Limitações Atuais

• A renderização de imagens Mermaid depende do Mermaid CLI e do suporte a imagens no terminal.
• A colocação inline assíncrona de imagens do iTerm2 está desabilitada na TUI porque o protocolo é vinculado à posição do cursor; use Kitty/Ghostty ou fallback ANSI para pré-visualizações interativas de imagens.
• A renderização de wireframe Mermaid é uma pré-visualização legível no terminal, não um motor de layout Mermaid completo.
• O modo raw é global para blocos Markdown renderizados; não é uma alternância por bloco.
• A renderização LaTeX cobre símbolos e expressões comuns, não layout TeX completo.
• Os comandos de cópia de fonte têm como alvo a última resposta da IA por padrão, ou a N-ésima última quando invocados como /copy N ....