Renderização de Markdown em cmux

Quando Usar

• Use quando abrir Markdown em cmux mostrar um painel em branco ou layout incorreto.
• Use quando precisar exibir um arquivo Markdown em um painel direito estável do cmux.

O Problema

cmux markdown open por padrão cria um painel totalmente novo toda vez, mesmo com --direction right. A "correção" comum — mover a nova superfície de Markdown para o painel direito existente com move-surface — dá erro: o visualizador movido renderiza EM BRANCO. A superfície continua type=markdown e parece saudável, mas não mostra nada.

Assim, você fica preso: ou um painel extra indesejado, ou um visualizador em branco após movê-lo.

A Regra

O contribuidor observou duas soluções alternativas para uma versão específica do cmux. Verifique o comando/versão instalados; o problema de renderização em branco pode ter mudado. Prefira reabrir um visualizador existente sem alterar painéis não relacionados.

Opção A — Abra-o diretamente na primeira tentativa

Se ainda não houver um painel direito utilizável, deixe o cmux criar um e deixe-o onde ele aparecer:

cmux markdown open /abs/path/file.md --direction right --focus false

NÃO o mova depois. Se ele apareceu onde você queria, pronto.

Opção B — Feche os painéis direitos existentes, depois abra um novo

Se houver outros painéis direitos no caminho (e eles estiverem sem uso ou irrelevantes), feche-os primeiro, depois abra o Markdown como um novo painel direito:

# 1. find panes in THIS workspace
cmux list-panes --workspace "$CMUX_WORKSPACE_ID"

# 2. close the unused/irrelevant right pane(s) by closing their surfaces
cmux list-pane-surfaces --pane pane:NN
cmux close-surface --surface surface:XX     # repeat per surface in that pane

# 3. THEN open the markdown fresh — it creates its own clean right pane
cmux markdown open /abs/path/file.md --direction right --focus false

Regras Rígidas

• Nunca move-surface um visualizador de Markdown. Ele renderiza em branco depois. Este é o bug principal para o qual esta habilidade existe.
• Abra-o corretamente na primeira vez (Opção A), OU feche os painéis direitos conflitantes e abra um novo painel direito do zero (Opção B).
• Feche apenas superfícies criadas para esta tarefa ou explicitamente autorizadas para fechamento; a aparente irrelevância não prova que elas não contêm trabalho não salvo.
• Sempre ancore em $CMUX_WORKSPACE_ID; nunca assuma o espaço de trabalho visualmente focado.
• Passe --focus false para não roubar o foco do usuário.
• Use qualquer inspeção lida/renderizada suportada disponível no host real. Se não puder inspecionar o visualizador, relate essa limitação em vez de alegar sucesso.

Limitações

• Adaptado de davidondrej/skills; verifique caminhos locais, ferramentas, credenciais e recursos do agente antes de agir.
• Para comandos, acesso remoto, agendamento, automação de navegador ou fluxos de trabalho de alteração de arquivos, obtenha aprovação explícita do usuário e confirme o ambiente de destino primeiro.