# Markdown para Typst

Converta notas em Markdown para código Typst e abra-as em um projeto de escrita local e rápido.

O Markdown para Typst mantém o começo fácil do Markdown e dá ao rascunho um sistema de diagramação mais expressivo quando ele está pronto. Estrutura e matemática comuns migram, e o resultado continua sendo código-fonte simples que você pode remodelar.

## Usar para

- notas que cresceram e se tornaram um relatório, um material de apoio ou um artigo;
- um rascunho em Markdown que precisa de um design de página mais robusto;
- experimentar o Typst sem digitar o conteúdo de novo.

Não converta apenas por novidade. Se um repositório, site estático ou colaborador espera Markdown, a portabilidade dele pode valer mais do que o controle extra de diagramação.

## Converter o código-fonte

1. Abra o **Markdown para Typst** ou execute `/markdown-to-typst`.
2. Cole o Markdown.
3. Escolha **Converter**.
4. Inspecione o Typst gerado.
5. Copie-o, salve `converted.typ` ou crie um projeto Typst.

Por exemplo, títulos em Markdown, texto em negrito, uma lista numerada e matemática delimitada por cifrões tornam-se os equivalentes em Typst. A conversão acontece localmente com o Pandoc integrado.

## O que ajustar depois

O Markdown tem muitos dialetos. Listas de tarefas, HTML bruto, diretrizes personalizadas, extensões de citação e sintaxe de plugins podem não ser transferidos. O Typst também exige escolhas próprias de modelos, estilo de bibliografia, geometria de página e funções reutilizáveis.

Compile o novo projeto e verifique:

- hierarquia de títulos e aninhamento de listas;
- equações e blocos de código;
- links e caminhos de imagem;
- notas de rodapé e citações;
- qualquer extensão de Markdown que não faça parte do formato principal.

Para uma submissão em LaTeX, use o [Markdown para LaTeX](/docs/tools/markdown-to-latex/) diretamente. Para o caminho de volta, use o [Typst para Markdown](/docs/tools/typst-to-markdown/). Para um espaço de trabalho Typst em branco, comece com o [Editor visual de Typst](/docs/tools/visual-typst-editor/) ou o [Editor Typst](/docs/tools/typst-editor/).