Tudo acontece numa única janela, e a imagem que você exporta é exatamente a imagem que você vê. Depois que o tema e o tamanho estão definidos, eles permanecem entre as aberturas do app — só o primeiro trecho exige pensar; cada um depois é colar e exportar.

1. Cole o seu código

Copie um trecho e cole direto no Codeshot com ⌘⇧V. Esse atalho substitui todo o código de qualquer ponto da janela, então não é preciso clicar no editor antes.

O colorido é aplicado ao colar. A linguagem é detectada pelo próprio código, entre 60 linguagens, e você pode forçá-la pelo menu Linguagem quando um trecho curto for ambíguo — três linhas de C e três de C++ são idênticas para qualquer detector.

Colar o texto em vez de capturar o editor é o ponto importante. Assim ficam de fora o cursor, o destaque da seleção, os ícones da lateral e a largura de linha do seu editor, que não têm nada a fazer na imagem.

2. Escolha um tema

São 30 temas de sintaxe, cada um com variante clara e escura. Você pode ver todos lado a lado, renderizados com as próprias folhas de estilo do app.

Duas coisas que vale saber na hora de escolher. Combine o tema com o seu editor se quiser que a imagem pareça familiar ao seu público — Xcode para Swift, GitHub para quase tudo. Mas se a imagem vai para um lugar onde será vista pequena, o contraste importa mais que a familiaridade, e os temas claros mais suaves perdem estrutura ao serem reduzidos num feed.

3. Escolha um fundo

O trecho fica sobre uma tela, e essa tela pode ser um dos 19 papéis de parede do macOS, um dos 92 gradientes, uma cor sólida sua ou uma imagem que você fornecer.

Você também pode desligar o fundo por completo e exportar com transparência, que é o que se quer quando a imagem vai para um slide ou uma página que já tem fundo próprio.

4. Ajuste a moldura

Defina o raio dos cantos da janela, o espaçamento interno, a margem em volta e a sombra. Os botões de semáforo e o título da janela podem ser ligados ou desligados, e você pode usar qualquer fonte monoespaçada instalada no seu Mac.

Esses são os ajustes que você mexe uma vez. Deixe do jeito que gosta e eles valem para todos os trechos seguintes — é boa parte do motivo de a décima imagem levar alguns segundos em vez de alguns minutos.

5. Exporte no tamanho certo

Deixe o tamanho acompanhar o conteúdo, ou trave numa proporção: 1:1, 4:3, 3:2, 16:9, 9:16, 2:3 ou 3:4. Os presets são atalhos sobre campos comuns de largura e altura, então qualquer outra proporção é só digitar.

Exporte em 1×, 2× ou 3×. Use 2× como padrão: uma exportação em 1× de texto pequeno fica borrada numa tela retina, e é a coisa que mais faz uma imagem de código parecer amadora.

Depois tire do app do jeito que preferir: copie direto para a área de transferência com ⌘⇧C, arraste a pré-visualização para outro app, ou salve com ⌘S.

Para onde vai

A proporção certa depende inteiramente do destino, e vale acertar porque cada plataforma corta de um jeito. Há guias por plataforma para X, LinkedIn e Facebook, e guias de tamanho para os demais.

Uma última coisa, dita sem rodeios: uma imagem não pode ser copiada, pesquisada nem lida por um leitor de tela. Quando o código é para ser usado, e não apenas olhado, publique um link para o fonte ao lado da imagem.