# CSV para Typst

Cole linhas CSV ou TSV e obtenha uma tabela Typst com escapes, uma linha de cabeçalho e réguas horizontais.

O CSV para Typst transforma linhas copiadas de uma planilha em uma tabela Typst. Cole as linhas, converta-as e cole a tabela no seu arquivo `.typ`.

## Quando usar

- você copiou um intervalo de uma planilha ou de um arquivo de resultados;
- os dados já são texto simples, como uma pequena exportação CSV;
- você quer um código-fonte Typst com escapes sem escrever você mesmo a chamada de `table`.

Para uma pasta de trabalho `.xlsx` ou `.xls`, use o [Excel para Typst](/docs/tools/excel-to-typst/). Para um documento LaTeX, use o [Excel para LaTeX](/docs/tools/excel-to-latex/).

## Converta linhas

1. Abra o **CSV para Typst** ou execute `/csv-to-typst`.
2. Cole linhas separadas por vírgula ou por tabulação, ou escolha **Carregar exemplo**.
3. Escolha **Converter**.
4. Confira a contagem de linhas e colunas na nota abaixo do resultado.
5. Copie a tabela ou salve `table.typ`.

Por exemplo:

```text
Method,Accuracy,Runtime (s)
Baseline,0.82,14.2
Oleafly,0.95,9.8
```

torna-se uma `#table` com três colunas. A primeira linha é o cabeçalho, em negrito. Colunas de números ficam alinhadas à direita e colunas de texto à esquerda. Réguas horizontais ficam acima do cabeçalho, abaixo dele e sob a última linha, sem linhas verticais.

## Comportamento da tabela

- O Oleafly detecta tabulações ou vírgulas a partir da primeira linha.
- Células entre aspas podem conter vírgulas, aspas e quebras de linha. Uma quebra de linha dentro de uma célula torna-se um espaço.
- Caracteres que o Typst leria como marcação, como `#`, `*`, `_` e `$`, recebem escape.
- A conversão roda no seu dispositivo.

:::caution[Limites de tamanho]
Uma tabela pode ter até 10.000 linhas e 100 colunas, com no máximo 2 MB de texto de célula.
:::

Dentro de um documento Typst, você pode pular o copiar e colar. Clique com o botão direito no editor e escolha **Tabela a partir de CSV/XLSX…**. Esse diálogo lê arquivos CSV, TSV, XLSX ou JSON, adiciona uma legenda e um rótulo opcionais e pode manter a tabela vinculada ao arquivo de dados dela, de modo que a tabela seja atualizada na próxima compilação. Veja [Escrever em Typst](/docs/writing/typst/).
