Conversor online gratuito de PNG para ADOC

Formato de origem: PNG

PNG (Portable Network Graphics) é um formato de imagem raster amplamente usado para capturas de tela, logotipos, diagramas, ícones e gráficos para a web. Ele oferece compressão sem perdas e transparência, o que o torna uma escolha comum quando a qualidade da imagem e as bordas limpas importam. Arquivos PNG normalmente são criados por editores gráficos, ferramentas de captura de tela, câmeras com opções de exportação e softwares de design.

Formato de destino: ADOC

ADOC é um arquivo de documento AsciiDoc, um formato de texto simples usado para escrever documentação técnica, manuais, arquivos README e livros. As principais vantagens são legibilidade, controle de versão fácil e publicação flexível para formatos como HTML, PDF e EPUB. Diferente do PNG, ADOC não é um formato de imagem; é um formato de marcação baseado em texto, então converter PNG para ADOC geralmente significa incorporar a imagem dentro de um documento AsciiDoc ou criar um arquivo AsciiDoc que referencia a imagem.

Como realizar a conversão

A melhor abordagem depende do que você quer que o arquivo ADOC contenha:

1. Se você quer um arquivo AsciiDoc que exiba a imagem PNG

Crie um novo arquivo .adoc e insira uma macro de imagem que aponte para o arquivo PNG:

image::picture.png[]

Se a imagem estiver em uma subpasta, use um caminho relativo como image::images/picture.png[].

Você pode criar ou editar o arquivo em qualquer editor de texto, como VS Code, Notepad++ ou Vim. Salve-o com a extensão .adoc.

2. Se você quer converter o PNG em conteúdo de documentação

Abra o PNG em um visualizador ou editor de imagens e descreva-o manualmente em AsciiDoc. Por exemplo, uma captura de tela pode ser transformada em documentação passo a passo com títulos, listas e a imagem incluída como uma figura.

3. Se você quer pré-visualizar ou publicar o resultado

Use um processador AsciiDoc como Asciidoctor para renderizar o arquivo:

asciidoctor file.adoc

Isso gera saída HTML por padrão. Se você precisar de PDF ou outros formatos, use o backend do Asciidoctor ou a toolchain apropriados.

Usando o conversor online embutido

Você pode converter o arquivo em 101convert.com gratuitamente, sem instalar nenhum software. Envie o PNG, escolha ADOC como formato de destino e faça download do resultado gerado. Isso é conveniente para conversões rápidas, especialmente quando você só precisa de um arquivo AsciiDoc simples que referencia ou empacota a imagem.

Notas sobre qualidade, compatibilidade e limitações

PNG para ADOC não é uma conversão verdadeira de imagem para texto. O ADOC não consegue armazenar dados de pixels do jeito que o PNG faz, então o resultado geralmente é ou um envoltório (wrapper) AsciiDoc em torno da imagem, ou um documento escrito manualmente que descreve a imagem. Se você precisa de OCR para extrair texto de uma captura de tela, use uma ferramenta de OCR primeiro e depois coloque o texto reconhecido no arquivo ADOC.

Para melhor compatibilidade, mantenha o arquivo PNG na mesma pasta do arquivo .adoc ou use um caminho relativo correto. Ao publicar, garanta que a imagem esteja acessível ao processador AsciiDoc. Arquivos PNG grandes podem aumentar o tamanho do documento e tornar a renderização mais lenta, enquanto PNGs transparentes geralmente funcionam bem na saída do AsciiDoc.

Se o seu objetivo é editar a própria imagem, converta-a para um formato de edição raster em vez disso; ADOC é feito para documentação, não para edição de imagens.