# Typst para Markdown

Converta marcação Typst em Markdown portátil que você pode copiar, salvar ou abrir como um projeto Markdown.

O Typst para Markdown mantém as palavras e a estrutura básica de um rascunho Typst e descarta o design de página. O resultado é texto simples que uma wiki, um repositório ou um editor Markdown consegue usar.

## Use quando

- a escrita importa mais do que o layout da página;
- você está movendo anotações ou um rascunho para um sistema em Markdown;
- um colaborador quer um código-fonte simples sem Typst.

Fique no Typst quando modelos, regras `show` ou o design exato da página fazem parte do resultado.

## Converta um rascunho

1. Abra o **Typst para Markdown** ou execute `/typst-to-markdown`.
2. Cole um trecho Typst ou um documento completo, ou escolha **Carregar exemplo**.
3. Escolha **Converter**.
4. Leia o resultado em Markdown.
5. Copie-o, salve `converted.md` ou escolha **Criar projeto** para abri-lo como um projeto Markdown.

Por exemplo:

```typst
= Method
We minimize $L(theta)$ with two constraints.
- Bounded error
- Stable updates
```

torna-se um título em Markdown, um parágrafo com matemática delimitada por cifrões e uma lista com marcadores.

## O que precisa de uma segunda olhada

O Pandoc embutido converte o código-fonte no seu dispositivo. Títulos, ênfase, links, listas, código e matemática comum normalmente mapeiam de forma limpa. Funções Typst, definições `#let`, regras `show` e `set`, pacotes e figuras com layout personalizado podem não mapear.

Confira depois os delimitadores de matemática, os caminhos de imagem, as notas de rodapé, as referências e as tabelas. Para exportar um projeto Typst inteiro como Markdown, use o menu **Exportar** do projeto, que preserva mais equações e referências. [Exportar e converter um projeto](/docs/export/) cobre o assunto.

Para a outra direção, use o [Markdown para Typst](/docs/tools/markdown-to-typst/). Para entregar a um editor de texto, use o [Typst para Word](/docs/tools/typst-to-word/).
