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 matemática LaTeX.

Modos Render e Raw

Por padrão, o Markdown é exibido no modo render. Blocos suportados são mostrados como prévias visuais quando possível:

• Blocos de código cercados do tipo Mermaid
• Tabelas Markdown
• Listas de tarefas
• Blockquotes
• Matemática LaTeX inline e em bloco
• Blocos de código cercados com realce de sintaxe

Pressione Alt/Option+M para alternar entre os modos na 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évias ricas no terminal para Markdown suportado.
• raw: mostra a fonte orientada a Markdown para blocos visuais como Mermaid, tabelas e LaTeX.

Para iniciar o Qwen Code no modo raw por padrão, configure 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ções.

Mermaid

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

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

A renderização de imagem Mermaid está desabilitada por padrão porque requer renderizadores externos e suporte a imagem 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 textual 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) · source: /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 de Mermaid mostrada no título renderizado.

Matemática LaTeX

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. Não é um motor TeX completo; layouts complexos como matrizes, equações alinhadas e expressões grandes aninhadas podem ser simplificadas.

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

Cópia da Fonte LaTeX

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

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

Cópia Geral de Código

O comando /copy code lê blocos de código cercados da última resposta 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 inteiro positivo para copiar da N-ésima última mensagem da IA — útil quando a resposta mais recente tem pouco sinal (por exemplo, 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 informa a contagem real em vez de copiar algo. Sem um inteiro inicial, subseletores como /copy code python 2 mantêm seu significado existente (o segundo bloco python na última mensagem).

Limitações Atuais

• A renderização de imagem Mermaid depende do Mermaid CLI e do suporte a imagem do terminal.
• A colocação assíncrona de imagem inline do iTerm2 está desabilitada na TUI porque o protocolo é vinculado à posição do cursor; use Kitty/Ghostty ou fallback ANSI para prévias interativas de imagem.
• A renderização wireframe do Mermaid é uma prévia textual 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 ....