# Exportar e converter um projeto

Salve o PDF mais recente, empacote o código-fonte editável, exporte imagens de página ou HTML, gere PDF/A e PDF/UA a partir do Typst ou converta um documento LaTeX, Typst ou Markdown.

Abra **Exportar** na barra de ferramentas do projeto. O menu acompanha o motor e o tipo do documento atual, então mostra apenas os caminhos que o Oleafly consegue executar para aquele projeto.

![Exportar é o controle de download logo depois de Compilar de novo na barra superior do projeto.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png#view=1282,0,232,48)

## Escolha a saída de que o destinatário precisa

- **PDF** serve para leitura, impressão e a maioria dos portais de submissão.
- **ZIP do código-fonte** serve para coautores ou sistemas que precisam do manuscrito, das figuras, da bibliografia e dos estilos locais.
- **PNG de página** serve para um slide, uma mensagem ou um sistema de revisão que espera uma imagem.
- **PNG, SVG ou HTML gerados pelo Typst** serve para projetos Typst que precisam de cada página como imagem, de páginas vetoriais ou de uma página web.
- **Word, HTML, Markdown, Typst, LaTeX ou texto simples** serve para alguém que precisa editar ou reutilizar o conteúdo em outro formato.
- **PowerPoint** serve para transformar uma apresentação ou um documento Markdown em slides. **EPUB** serve para um leitor de e-books. Quais deles aparecem depende do motor. Veja [Exportações de apresentação e livro](#presentation-and-book-exports).

## Salvar um PDF, um pacote do código-fonte ou uma imagem de página

1. Escolha **Compilar de novo** para que a saída inclua as suas edições mais recentes.
2. Inspecione o PDF, incluindo as páginas finais e a bibliografia.
3. Abra **Exportar**.
4. Escolha **Exportar como PDF**, **Exportar o código-fonte (.zip)** ou **Exportar a página como PNG**.
5. Escolha um destino na caixa de diálogo de salvamento.
6. Escolha **Mostrar na pasta** na mensagem de conclusão para encontrar o arquivo salvo.

As ações de PDF e de imagem de página ficam desativadas até o projeto ter um PDF, e o menu diz **O PDF precisa de uma compilação antes**. **Exportar como PDF** salva o PDF exibido na prévia. **Exportar a página como PNG** salva a página que você está vendo na prévia, em alta resolução.

Um pacote do código-fonte exclui caches de compilação e os recursos internos do Git. Ele também deixa de fora os links simbólicos, e a mensagem de conclusão diz quantos foram pulados.

### Quando o PDF não está atualizado

O Oleafly ainda salva o PDF ou a imagem de página quando a prévia está desatualizada, e a mensagem de conclusão avisa:

- Depois de uma compilação que falhou, ela diz que a última compilação falhou, então o arquivo pode estar incompleto.
- Depois de edições que você não compilou, ela diz que o arquivo vem da última compilação e não inclui as suas edições mais recentes.

Compile de novo, confira a prévia e exporte outra vez antes de enviar o arquivo a alguém.

## Imagens e HTML no Typst

O menu Exportar de um projeto Typst também tem **Imagens e HTML**, que abre **Exportar com o Typst**. O próprio Typst desenha esses arquivos, então as páginas PNG e SVG ficam exatamente como o PDF.

- **Imagens PNG** aceitam uma **Resolução** de 72, 144, 300 ou 600 PPI.
- **Imagens SVG** mantêm as páginas como gráficos vetoriais.
- **HTML** está marcado como **Experimental**. O HTML do Typst mantém texto e imagens, mas deixa de fora a configuração de página e os desenhos. Antes do Typst 0.15, ele deixa de fora as equações também, e a caixa de diálogo avisa isso quando você escolhe HTML.

Para PNG e SVG, **Páginas** aceita números e intervalos de páginas, como `1, 3-5` ou `8-`. Deixe vazio para todas as páginas. Cada página é salva em um arquivo próprio, numerado a partir do nome que você escolher. Intervalos de páginas precisam do Typst 0.12 ou posterior, e o HTML precisa do Typst 0.13 ou posterior. A caixa de diálogo só oferece o que a versão do Typst do projeto consegue fazer. Se o projeto tiver [variantes de compilação](/docs/typst/#build-variants-and-sysinputs), a exportação usa a que está selecionada no menu de compilação.

## PDF/A e PDF/UA a partir do Typst

O próprio Typst gera PDFs arquiváveis e acessíveis. Abra o **escudo** na barra lateral do projeto para a [Pré-verificação](/docs/preflight/) e encontre **Padrões de PDF** na verificação de **Acessibilidade**. Escolha um **Padrão**, como PDF/A-2b ou PDF/UA-1, e depois **Exportar PDF**.

A lista depende da versão do Typst do projeto. O Typst 0.11 não oferece nenhum, o Typst 0.12 oferece PDF/A-2b, o Typst 0.13 acrescenta o PDF/A-3b, e o Typst 0.14 e posteriores oferecem todos os níveis de PDF/A mais o PDF/UA-1. O Typst 0.14 e posteriores também marcam todo PDF para leitores de tela, então não há uma compilação marcada separada. O PDF/UA-1 precisa de um título de documento e de texto alternativo em cada imagem, e a Pré-verificação confere os dois.

## Formatos editáveis

| Motor do projeto | Formatos em Exportar |
| --- | --- |
| **LaTeX** | Word, HTML autossuficiente com MathML, Markdown, Typst e texto simples |
| **Typst** | LaTeX, Word, HTML autossuficiente com MathML, Markdown e texto simples |
| **Markdown** | Word, HTML autossuficiente com MathML, Typst, LaTeX e texto simples |

Um projeto Typst também oferece EPUB, e um projeto Markdown oferece PowerPoint e EPUB. Um projeto LaTeX só os oferece para uma classe de documento compatível.

Essas conversões rodam localmente pelo Pandoc. O Oleafly usa uma instalação compatível no seu computador ou baixa uma compilação gerenciada e verificada na primeira vez em que ela for necessária.

Projetos Typst seguem outro caminho. O Typst primeiro grava o documento como HTML, e o Pandoc transforma esse HTML em Word, HTML, Markdown, LaTeX, texto simples ou EPUB, então as equações e as referências chegam inteiras. Se um documento pode seguir esse caminho depende da versão do Typst do projeto:

| Versão do Typst | Caminho |
| --- | --- |
| 0.15 ou posterior | Pelo HTML |
| 0.13 e 0.14 | Pelo HTML quando o Typst consegue gravar o documento inteiro. Quando não consegue, o Pandoc lê o código-fonte Typst. |
| 0.12 ou anterior | O Pandoc lê o código-fonte |

Se o Typst parar com um erro ao gravar o HTML, o Pandoc lê o código-fonte em qualquer versão. Quando o Pandoc lê o código-fonte no Typst 0.13 ou 0.14, a mensagem de conclusão avisa que texto girado, redimensionado, movido ou inclinado pode estar faltando, a menos que a exportação tenha avisos. Para a exportação mais completa, mude o projeto para o Typst 0.15 ou posterior em **Versão do Typst (deste projeto)** no menu de compilação.

Quando a exportação passa pelo HTML, o texto dentro de funções de layout como `align`, `grid` e `rotate` continua nele. Um desenho feito com CeTZ perde as linhas e as formas e fica só com os rótulos de texto, e a mensagem de conclusão diz o que o Typst deixou de fora.

## Converter um documento

1. Compile uma vez e corrija os erros do código-fonte.
2. Abra **Exportar** e escolha o formato de destino.
3. Conclua a configuração do Pandoc se for solicitado. Se o Oleafly disser que o Pandoc não está disponível, escolha **Reparar o Pandoc** em **Configurações → Motores → Markdown** e exporte de novo.
4. Salve o arquivo convertido com a extensão sugerida.
5. Leia a mensagem de conclusão. Se ela mencionar avisos, escolha **Mostrar avisos** para ver o que a exportação deixou de fora.
6. Abra o arquivo no aplicativo de destino e confira a estrutura e a aparência.

Para um teste rápido, exporte uma seção curta que contenha um título, uma equação, uma tabela, uma imagem e uma citação. Se esses cinco elementos sobreviverem bem, converta o manuscrito completo e revise-o de novo.

Para transformar um projeto LaTeX inteiro em um projeto Typst no qual você continue trabalhando, use [Converter em um projeto Typst](/docs/typst/#convert-a-latex-project-to-typst). Ele cria um projeto novo e relata o que precisa de atenção.

### O que a conversão preserva

O Pandoc procura preservar títulos, parágrafos, listas, links, citações, tabelas, imagens e matemática editável. Ele não consegue reproduzir todo recurso da linguagem de origem em todo destino. Confira de perto estas áreas:

- comandos e ambientes LaTeX personalizados
- layout de página ou flutuantes ajustados à mão
- tabelas complexas ou aninhadas
- estilo de bibliografia e renderização de citações
- funções Typst sem equivalente direto no destino
- HTML bruto ou extensões de Markdown

A exportação HTML embute os recursos e grava as equações como MathML. Isso a torna útil para compartilhar um documento que deve abrir sozinho, mas ainda vale a pena testá-la nos navegadores que os seus leitores usam.

### O que cada formato preserva

- As exportações para Word e PowerPoint transformam figuras PDF, SVG e WebP em imagens PNG a 220 ppi. Uma figura sem tamanho no código-fonte mantém a própria largura.
- As exportações para HTML e EPUB transformam figuras PDF em imagens PNG.
- Markdown e texto simples exportados do LaTeX mantêm o título, o autor e o resumo.
- Exportações para Markdown ou Typst a partir do LaTeX, e para LaTeX ou Typst a partir do Markdown, apontam para os arquivos de figura do projeto em vez de copiá-los. A menos que a exportação tenha avisos, a mensagem de conclusão lembra você de copiar as imagens e a bibliografia para junto do arquivo exportado antes de compilá-lo. Um documento Markdown exportado para Typst ou LaTeX mantém a bibliografia que declara, ou os arquivos `.bib` do projeto se não declarar nenhuma.
- Uma exportação para LaTeX de um documento Markdown segue o [tipo de documento](/docs/writing/markdown/#document-types) dele. Slides e pôsteres viram código-fonte Beamer, um relatório ou livro começa os capítulos nos títulos `#`, e uma carta vira uma carta KOMA-Script.
- Uma exportação para LaTeX a partir do Typst copia as imagens do documento para uma pasta `<name>-media` ao lado do arquivo `.tex`. Imagens SVG, GIF e WebP viram PDF ali, porque o LaTeX não consegue lê-las.

As exportações procuram figuras na pasta do documento principal, na raiz do projeto e em qualquer pasta de `\graphicspath`, e encontram uma figura nomeada sem a extensão. Figuras EPS não podem ser convertidas, então entram no arquivo sem alteração, com um aviso. Em uma exportação para Word, HTML, EPUB ou PowerPoint de um documento Markdown, um bloco Mermaid mostra a figura salva para ele.

### Avisos depois de uma exportação

O Pandoc deixa de fora o que um formato não consegue guardar. Quando isso acontece em uma exportação de um projeto LaTeX ou Markdown, ou em uma exportação Typst que lê o código-fonte, a mensagem de conclusão diz que o arquivo foi salvo com avisos e quantos, no lugar das outras notas, como o lembrete de copiar as imagens. Escolha **Mostrar avisos** para abrir **Avisos da exportação**, que lista o que ficou de fora. **Mostrar na pasta**, nessa caixa de diálogo, abre a pasta com o arquivo salvo.

A lista pode citar:

- um bloco que a exportação deixou de fora, com o arquivo e a linha quando conhecidos, como um `tikzpicture`, um `\includepdf` ou um comando de sobreposição do Beamer como `\only` ou `\uncover`
- uma figura que a exportação não encontrou ou não conseguiu converter
- uma chave de citação que não está na bibliografia
- matemática que ficou como código TeX
- referências que ainda não têm número, o que uma compilação resolve

Um aviso repetido aparece uma vez, e a lista para em 50. Uma exportação para PowerPoint funciona de outro jeito quando falta uma figura: ela para, não salva nenhum arquivo, e o erro nomeia a figura. As exportações Typst que passam pelo HTML dizem o que o Typst deixou de fora na mensagem de conclusão.

## Exportações de apresentação e livro

Um projeto LaTeX associa essas exportações à classe do documento. **Exportar como PowerPoint (.pptx)** aparece para uma apresentação Beamer, e **Exportar como EPUB (.epub)** para as classes `book`, `report`, `memoir`, `scrbook` e `scrreprt`.

Em uma apresentação Beamer, cada frame inicia um slide novo, `\section` acrescenta um slide de seção e `\subsection` não acrescenta nenhum. Um frame com mais de uma imagem, ou com uma imagem e outro conteúdo, pode se estender para um segundo slide.

Em projetos Typst e Markdown, o menu não confere o documento para essas exportações. Um projeto Markdown sempre oferece as duas, e um projeto Typst sempre oferece EPUB. Quando um documento Markdown se torna PowerPoint, cada título de nível 1 vira um slide de seção e cada título de nível 2 inicia um slide novo. A exceção é um documento com `type: slides`: uma linha `slide-level` no front matter dele escolhe o nível de título que inicia um slide. Todo EPUB recebe um sumário, e as equações dele são MathML.

Use essas exportações como pontos de partida editáveis. A composição de slides e a tipografia de livros raramente correspondem um a um entre formatos, então inspecione cada slide ou capítulo no aplicativo de destino.

## Exportar uma figura independente

Um projeto de figura independente oferece **Exportar como PDF (imagem vetorial)** e **Exportar como PNG** depois da compilação. Escolha PDF para linhas e textos nítidos em qualquer escala. Escolha PNG quando o destino só aceita imagens raster.

## Salvar a saída dentro do projeto

A [prévia do PDF](/docs/pdf-preview/) também oferece **Salvar o PDF no projeto**. Isso mantém uma cópia de submissão ou uma figura compilada ao lado do código-fonte. Para manter essa cópia atualizada, ative [Sincronizar PDF ao compilar](/docs/pdf-preview/#sync-pdf-on-compiles) no mesmo menu, e o Oleafly atualiza um PDF com o nome do projeto depois de cada compilação bem-sucedida. Um PDF anterior pode ser salvo a partir de um [ponto de verificação](/docs/checkpoints/#save-a-pdf-from-a-checkpoint) sem restaurar o projeto. Adicione esse arquivo ao [histórico do Git](/docs/git-history/) somente quando você quiser versionar a saída gerada.

## Confira antes de compartilhar

Rode a [Pré-verificação](/docs/preflight/) antes de uma submissão. Se você precisar de um PDF marcado, siga o fluxo de exportação acessível para LaTeX ou escolha um padrão PDF/UA em um projeto Typst e depois verifique o resultado com um verificador PDF/UA independente e uma revisão humana de acessibilidade. A Pré-verificação confere muitos sinais úteis, mas não certifica conformidade.
