Conversor online gratuito de ASCIIDOC para TYP

O Typst requer documentos de origem em seu formato de marcação .typ, enquanto muitos projetos de documentação são criados como arquivos .adoc ou .asciidoc. A conversão entre eles permite reutilizar documentação estruturada em um fluxo de publicação do Typst sem recriar manualmente cada título, lista e referência.

O que é o formato ASCIIDOC

AsciiDoc é um formato de marcação de texto simples para documentação técnica, manuais, arquivos README, livros e páginas da Web. Os arquivos normalmente usam .adoc ou .asciidoc; Asciidoctor e Asciidoctor.js os criam e processam. O formato oferece suporte a títulos, listas, tabelas, blocos de código-fonte, referências cruzadas, atributos, includes, admonitions, imagens e metadados de documentos.

O que é o formato TYP

Na categoria Text files, .typ denota a marcação de origem do Typst. Typst é um sistema de composição tipográfica cujo compilador transforma arquivos de origem em PDF e outras saídas renderizadas. Os arquivos TYP combinam uma sintaxe de origem legível com instruções de layout para títulos, figuras, tabelas, citações, configurações de página e funções reutilizáveis. Eles são úteis quando o fluxo de trabalho de destino usa o compilador Typst em vez de um renderizador AsciiDoc ou de uma toolchain LaTeX.

Como converter ASCIIDOC em TYP na prática

A rota automatizada mais confiável é usar Asciidoctor para converter em DocBook XML e, em seguida, Pandoc para converter em Typst. Instale o Asciidoctor e uma versão atual do Pandoc e execute:

asciidoctor -b docbook5 -o document.xml document.adoc
pandoc -f docbook -t typst -o document.typ document.xml

Substitua document.adoc pelo nome do arquivo de origem. O primeiro comando expande a estrutura AsciiDoc para DocBook; o segundo mapeia os elementos DocBook para a marcação Typst. Compile o resultado com:

typst compile document.typ

Para um arquivo AsciiDoc que dependa de atributos, defina-os durante a conversão, por exemplo:

asciidoctor -a revnumber=2.0 -a showtitle -b docbook5 -o document.xml document.adoc

Você também pode usar o conversor gratuito em 101convert.com sem instalar software: selecione o formato de origem ASCIIDOC, carregue o arquivo, escolha TYP e salve o resultado convertido.

Limitações de qualidade e compatibilidade

Esta é uma tradução de marcação, não uma alteração de formato em nível de bytes. Títulos básicos, parágrafos, ênfase, listas, tabelas, blocos de código e muitos links geralmente são transferidos corretamente, mas atributos AsciiDoc, conteúdo condicional, roles personalizados, macros, extensões, includes e blocos de diagramas podem exigir reescrita manual no Typst.

Resolva os includes e gere os assets externos antes da conversão sempre que possível. Verifique os caminhos das imagens, as larguras das tabelas, as citações, as configurações de página e as referências cruzadas no arquivo .typ gerado. O Pandoc pode preservar o conteúdo enquanto altera a semântica do layout; portanto, compile o arquivo com Typst e inspecione o PDF renderizado em vez de confiar apenas na origem convertida.