Arquivos grandes

O VMark abre a maioria dos arquivos markdown instantaneamente, mas arquivos muito grandes precisam de cuidados extras para manter a responsividade. Esta página descreve como o VMark os trata e como você pode ajustar o comportamento.

O que conta como "grande"

O VMark classifica um arquivo pelo tamanho e, para markdown, por uma contagem estimada de blocos antes de abri-lo:

Tamanho ou contagem de blocos	Categoria	O que acontece
< 1 MB e menos de 1.200 blocos estimados	Pequeno	Abre em modo WYSIWYG (rich-text) instantaneamente.
1 MB – 5 MB, ou 1.200+ blocos estimados	Grande	Abre em modo Fonte por padrão — em menos de um segundo. A barra de status oferece "Mudar para WYSIWYG".
5 MB – 50 MB	Enorme	Aparece primeiro um diálogo de confirmação. Abre apenas em modo Fonte.
≥ 50 MB	Recusado	O VMark se recusa a abrir o arquivo. Use less, bat ou ferramenta similar.

O tamanho é verificado pelo sistema operacional sem ler o arquivo. Quando um arquivo markdown tem menos de 1 MB, o VMark estima em seguida sua contagem de blocos com uma varredura linha a linha dos bytes — não uma análise de markdown —, então a decisão continua rápida e o documento nunca é carregado no webview.

Por que modo Fonte para arquivos grandes

O modo Fonte usa o CodeMirror com virtualização de viewport — apenas a porção visível do documento é renderizada. O modo WYSIWYG usa Tiptap/ProseMirror, que precisa construir um nó DOM para cada bloco do documento. Em um arquivo markdown de 1,4 MB / ~2.250 blocos isso leva cerca de 15 segundos na primeira abertura; o modo Fonte abre o mesmo arquivo em menos de um segundo.

O custo de construir a visualização acompanha a contagem de blocos, não o tamanho do arquivo. Três fixtures de tamanho quase idêntico (377–397 KB), diferindo apenas em como seus bytes são divididos em blocos, abriram em 3,6, 5,2 e 18 segundos com 601, 1.201 e 3.401 blocos. Um documento de 524 KB com 3.773 blocos curtos levou mais de 30 segundos naquela máquina — abaixo do limite de 1 MB, mas muito além do ponto em que a janela para de responder. É por isso que a estimativa de blocos pode encaminhar um arquivo para o modo Fonte sozinha.

A maior parte desse tempo vai para construir e diagramar a view, não para o parsing. Em um documento CJK longo medido em uma máquina lenta, o parsing foi entre um quarto e dois quintos do custo de abertura do editor.

Enquanto um documento abre

Uma janela responde aos menus, atalhos e ao botão de fechar antes de o VMark construir a view de texto rico do documento, que aparece logo em seguida. Antes, um documento longo era construído primeiro e, em uma máquina lenta, isso podia impedir a janela de ficar pronta: os menus respondiam com atraso e o log registrava menu commands did not mount within 5000ms.

O que o WYSIWYG faz ao abrir também fica proporcional ao documento:

• As imagens carregam quando se aproximam da área visível.
• Espaçamento entre Letras CJK (Configurações → Editor → Tipografia) não faz nenhum trabalho enquanto está desligado, o padrão, e percorre o documento uma única vez quando está ligado.
• Decorações como o destaque de código, o espaçamento CJK e as marcações de lint custam aproximadamente de forma linear com o tamanho do documento. Documentos muito longos custavam de forma quadrática.

Indicadores na barra de status

• Abrir um arquivo grande em WYSIWYG: um spinner indeterminado com o rótulo "Abrindo arquivo grande (N MB)…" aparece à esquerda da barra de status enquanto o editor é montado. Ele desaparece assim que o editor fica interativo.
• Arquivo aberto automaticamente em modo Fonte: a barra de status mostra "Aberto em modo Fonte (arquivo grande)." com um link Mudar para WYSIWYG. Clicar no link alterna a aba ativa para WYSIWYG. Fechar e reabrir o arquivo retorna ao modo Fonte — o override é por sessão.
• Documento que o WYSIWYG não consegue exibir: um documento com citações ou listas aninhadas em mais de 1000 níveis não pode ser analisado como texto formatado, qualquer que seja o tamanho. Ele abre no modo Fonte com uma mensagem informando a profundidade, e a barra de status mostra "Aberto no modo Fonte (não pode ser exibido no WYSIWYG)." Reduza o aninhamento e depois use Mudar para WYSIWYG.

Configurações

Abra Configurações → Editor → Arquivos grandes:

• Abrir arquivos grandes em modo Fonte automaticamente (ligado por padrão) — inclui arquivos acima de 1 MB e markdown com muitos blocos. Desligue se preferir WYSIWYG para arquivos de até 5 MB, aceitando o tempo de abertura mais longo.
• Avisar antes de abrir arquivos acima de 5 MB (ligado por padrão) — desligue para pular o diálogo de confirmação para arquivos entre 5 MB e 50 MB. Eles ainda abrirão em modo Fonte.

A recusa fixa em 50 MB não é ajustável pelo usuário. A webview não consegue manter strings arbitrariamente grandes com segurança sem risco de falhas por falta de memória.

Dicas

• Se você precisa continuar editando um arquivo muito grande em WYSIWYG, considere dividi-lo em arquivos menores ligados por um documento índice. O Markdown funciona bem como um conjunto de capítulos menores.
• Se você só precisa ler ou pesquisar em um arquivo grande, modo Fonte com a régua de números de linha e Find (Mod + F) costuma ser o fluxo mais rápido.
• Formatar → CJK → Formatar arquivo inteiro e outros comandos para o documento inteiro continuam funcionando corretamente em documentos no modo Fonte.

Casos de borda

• O arquivo cresce enquanto está aberto. O VMark decide a categoria com base no tamanho no momento da abertura. Um arquivo que cresce para 2 MB enquanto você o edita permanece no modo que você escolheu.
• Symlinks. Os tamanhos refletem o arquivo de destino, então um symlink para um arquivo de 10 MB é tratado como enorme.
• Arquivos vazios. Arquivos de zero bytes contam como pequenos e abrem em WYSIWYG.
• Arquivo desaparece entre a verificação de tamanho e a leitura. O erro normal de "arquivo não encontrado" é exibido — nenhum aviso adicional é levantado.

Limitações conhecidas

• A contagem de blocos é uma estimativa, não uma análise: texto separado por linhas em branco, títulos, itens de lista, linhas de tabela e cada bloco de código delimitado contam como um bloco, enquanto o código dentro de uma cerca e as linhas de frontmatter são ignorados. Um documento com formato incomum pode ser encaminhado para o modo Fonte quando o WYSIWYG teria sido rápido o suficiente; Mudar para WYSIWYG é um clique. Arquivos que não são markdown nunca são encaminhados pela contagem de blocos.
• O WYSIWYG ainda constrói todos os blocos do documento ao abrir — só as imagens e as fórmulas matemáticas em linha esperam até se aproximarem da área visível — então mudar um arquivo grande para WYSIWYG custa todo o tempo de abertura descrito acima.