# Excel para Typst

Transforme a primeira planilha de um arquivo Excel, CSV ou TSV em uma tabela Typst com escapes.

O Excel para Typst leva uma tabela pronta de uma planilha para um documento Typst. Ele lê o arquivo, aplica escape em cada célula e escreve a chamada de `#table` para você.

## Melhor para

Use-o para uma tabela retangular e limpa: resultados, estatísticas de resumo ou uma grade de comparação preparada em uma planilha. A primeira linha torna-se um cabeçalho em negrito.

Se as linhas já estão na sua área de transferência, o [CSV para Typst](/docs/tools/csv-to-typst/) aceita texto colado. Para um documento LaTeX, use o [Excel para LaTeX](/docs/tools/excel-to-latex/). Mantenha gráficos e plotagens como figuras.

## Converta uma planilha

1. Abra o **Excel para Typst** ou execute `/excel-to-typst`.
2. Escolha um arquivo `.xlsx`, `.xls`, `.csv` ou `.tsv`.
3. Escolha **Converter**.
4. Confira a contagem de linhas e colunas na nota abaixo do resultado.
5. Copie a tabela ou salve `table.typ` e depois cole no seu documento.

Uma planilha como esta:

| Modelo | Acurácia | Tempo (s) |
| --- | ---: | ---: |
| Linha de base | 0.81 | 12.4 |
| Proposto | 0.87 | 10.9 |

torna-se uma tabela Typst de três colunas. Colunas numéricas ficam alinhadas à direita, colunas de texto à esquerda, e réguas horizontais marcam o topo, o cabeçalho e a base. O Typst não precisa de pacote extra para isso.

## Comportamento da planilha

- O Oleafly lê a **primeira planilha** de uma pasta de trabalho.
- Células de fórmula usam o resultado em cache no arquivo. Recalcule e salve a planilha primeiro se os valores puderem estar desatualizados.
- Um intervalo mesclado contribui com o valor da célula superior esquerda. As demais células ficam vazias.
- Caracteres que o Typst leria como marcação recebem escape.
- A conversão fica no seu dispositivo.

:::caution[Limites de tamanho e layout]
A planilha pode conter até 10.000 linhas e 100 colunas, com no máximo 2 MB de texto de célula. Gráficos, cores, estilos de célula, fórmulas e vínculos entre planilhas não são reproduzidos.
:::

Para trazer um arquivo de dados para um documento Typst aberto, clique com o botão direito no editor e escolha **Tabela a partir de CSV/XLSX…**. Esse diálogo também lê JSON, aceita uma legenda e um rótulo e pode manter a tabela vinculada a uma cópia dos dados no projeto, de modo que editar os dados atualize a tabela na próxima compilação.
