Pré-visualizar código, Markdown e ZIP na Visualização Rápida do Mac

Selecione um arquivo Swift ou Python no Finder e pressione a barra de espaço: a Visualização Rápida mostra o código como texto simples, tudo de uma cor só. Um README.md mostra seus # e ** em vez de títulos e negrito. E um arquivo ZIP mostra o ícone, o nome e o tamanho, mas nenhum dos arquivos que estão dentro.

A Visualização Rápida só mostra o que uma pré-visualização instalada no seu Mac sabe desenhar. As pré-visualizações que vêm com o macOS tratam código, JSON e Markdown como texto simples, e nenhuma lê um arquivo compactado. Desde o macOS Sequoia, os antigos plug-ins que preenchiam essa lacuna não são mais carregados: as melhores pré-visualizações agora vêm de extensões da Visualização Rápida instaladas pelos apps. O Folia Files traz uma. Com ela, a barra de espaço no Finder e no Mail mostra o código com cores de sintaxe e números de linha, o JSON indentado, o Markdown renderizado e a lista de arquivos de um ZIP ou TAR.

O que a Visualização Rápida mostra sozinha

Só com o macOS, a barra de espaço (ou ⌘Y) sobre um arquivo mostra:

• Código-fonte (Swift, Python, JavaScript, scripts de shell…): texto simples, sem cores nem números de linha.
• JSON: também texto simples, sem cores.
• Markdown: o texto bruto, com todos os #, * e [links](…) à vista.
• Arquivos ZIP e TAR: o ícone, o nome e o tamanho do arquivo compactado, nada sobre o conteúdo.

Os arquivos CSV são a exceção: o macOS já os mostra como tabela.

Por quê: os plug-ins foram aposentados e as extensões assumiram

A Visualização Rápida escolhe uma pré-visualização de acordo com o tipo do arquivo. O macOS tem as suas para texto, imagens, PDF, áudio e vídeo, documentos do Office e do iWork e alguns outros. Para o macOS, código-fonte, JSON e Markdown são tipos de texto: todos recebem a pré-visualização de texto simples, e nenhuma pré-visualização do sistema lê o que um arquivo compactado contém.

Durante anos, dava para acrescentar pré-visualizações colocando plug-ins .qlgenerator na pasta QuickLook da sua Biblioteca. O macOS Sequoia (15) deixou de carregá-los, e as pré-visualizações instaladas assim sumiram. Agora, uma pré-visualização nova precisa ser uma extensão da Visualização Rápida que vem dentro de um app: você instala o app e o macOS usa a extensão dele.

Dois lugares mostram o que está acontecendo:

• Ajustes do Sistema › Geral › Itens de Início de Sessão e Extensões: na seção Extensões, Visualização Rápida lista as extensões de pré-visualização instaladas pelos seus apps e permite desativar cada uma.
• Terminal: qlmanage -p ~/Desktop/README.md abre a pré-visualização de um arquivo como o Finder a mostra, e qlmanage -m plugins lista as pré-visualizações integradas ao macOS com os tipos de arquivo que cada uma atende (as extensões dos apps não aparecem ali).

A extensão da Visualização Rápida do Folia Files

O Folia Files é um gerenciador de arquivos para Mac e vem com uma extensão da Visualização Rápida. Não há mais nada para instalar: assim que o app está na sua pasta Aplicativos e foi aberto uma vez, a barra de espaço usa a extensão em todo lugar onde o macOS mostra pré-visualizações da Visualização Rápida: no Finder e na mesa, nos anexos do Mail e em outros apps.

A captura abaixo foi feita dentro do Folia Files, no módulo Pré-visualização; no Finder, a extensão colore o mesmo arquivo do mesmo jeito e ainda mostra os números de linha na margem.

O que ela mostra

• Código: Swift, Python, JavaScript, Ruby, PHP, Perl, scripts de shell, C e C++, Objective-C, Java, SQL, CSS, YAML e outras linguagens que o macOS reconhece como código-fonte. Palavras-chave, strings, números, comentários e nomes de tipos ganham cada um uma cor, com números de linha na margem, no modo claro ou escuro como o seu Mac. Só os primeiros 600 KB de um arquivo são mostrados.
• JSON: indentado e colorido, com as chaves em ordem alfabética, então a ordem pode ser diferente da do arquivo. Um arquivo que não é JSON válido aparece como está.
• Markdown: renderizado, com títulos, negrito e itálico, listas com marcadores, numeradas e de tarefas, citações, tabelas, blocos de código e links.
• Arquivos ZIP e TAR, sem compressão ou compactados com gzip (.tar.gz, .tgz): o número de arquivos e o tamanho deles depois de extraídos, e então cada pasta e cada arquivo, com recuo, com o tamanho de cada arquivo (até os primeiros 5.000 itens).

Para outros formatos de arquivo compactado, como 7z ou RAR, e para os arquivos CSV, o macOS mantém a própria pré-visualização.

Alguns tipos de arquivo escapam dela, porque o macOS não os vê como código. A extensão .ts do TypeScript também é a dos vídeos MPEG transport stream, então o macOS trata esses arquivos como vídeo. Arquivos Go ou Rust muitas vezes não têm um tipo que o macOS reconheça, a não ser que outro app declare um. Para esses, o Finder mantém a pré-visualização de sempre.

Desativá-la ou escolher entre dois apps

Em Ajustes do Sistema › Geral › Itens de Início de Sessão e Extensões, a extensão aparece como Folia Files em Visualização Rápida. Desative-a e o macOS volta às próprias pré-visualizações.

Se outro app do seu Mac também tiver uma extensão da Visualização Rápida para Markdown ou código, o Finder mostra só uma pré-visualização para o mesmo arquivo. Para ter a outra, desative na mesma lista a extensão que você não quer.

A extensão faz parte das duas versões do Folia Files, a do site e a da Mac App Store.

Dentro do Folia Files: as mesmas pré-visualizações, com mais espaço

No próprio Folia Files, a barra de espaço abre a janela de pré-visualização do app para código, Markdown, JSON, CSV e arquivos compactados; fotos, PDFs, vídeos e outros documentos vão para a Visualização Rápida, como sempre. A janela flutua sobre os painéis: as setas continuam percorrendo os arquivos e a pré-visualização acompanha, e a barra de espaço a fecha. É o ajuste Pré-visualizações do Folia Files para código, Markdown, JSON, CSV e arquivos compactados (barra de espaço), em Ajustes › Arquivos e Rede › Pré-visualizações e arquivos compactados.

Para manter uma pré-visualização ao lado dos seus arquivos enquanto trabalha, use o módulo Pré-visualização, um dos módulos do Folia Files: adicione-o à barra lateral direita com o botão Módulos dela, ou arraste Novo Painel da barra de ferramentas até a borda da janela e escolha Pré-visualização na grade. Ele mostra o que você seleciona no painel ativo.

Botões no topo trocam a visualização: Renderizado, Origem e Hexadecimal para o Markdown, Formatado para o JSON, Tabela para o CSV, Conteúdo para um arquivo compactado. As cores e a renderização do Markdown são as mesmas da extensão.

Os arquivos compactados têm mais uma opção: clique duas vezes num ZIP em um painel do Folia Files e ele abre como uma pasta, somente para leitura, para você copiar só os arquivos de que precisa. Como abrir um arquivo ZIP sem descompactar no Mac explica como funciona.

Em resumo

• Código colorido, JSON indentado, Markdown renderizado e conteúdo de arquivos compactados no Finder e no Mail: instale o Folia Files e abra-o uma vez; a barra de espaço faz o resto.
• Voltar às pré-visualizações do macOS: desative o Folia Files em Visualização Rápida, em Ajustes do Sistema › Geral › Itens de Início de Sessão e Extensões.
• Uma pré-visualização que fica aberta ao lado dos seus arquivos: o módulo Pré-visualização do Folia Files, na barra lateral direita ou num painel só dele.