Guia de edição

Como limpar o Markdown convertido

O Markdown convertido é um rascunho montado a partir de pistas estruturais de outro formato. Trabalhe em etapas: remova o ruído da extração, repare o esboço, normalize a sintaxe de blocos, verifique referências e só então polir a prosa.

Leitura de 10 minutos

Preserve a conversão bruta antes de editar

Mantenha o resultado convertido como um documento próprio e guarde o arquivo-fonte até que a revisão esteja concluída. Isso dá a você uma referência quando texto parece estar faltando ou fora de ordem e evita que um rascunho não salvo e não relacionado seja sobrescrito.

Use o desfazer após ações de limpeza automatizadas e faça uma categoria de mudança por vez. Uma reescrita ampla pode remover acidentalmente espaçamento intencional dentro do código ou alterar o aninhamento de listas que já estava correto.

Remova o ruído da extração

Cabeçalhos de PDF, números de página, rodapés repetidos, rótulos de slides, linhas vazias de tabela e linhas em branco duplicadas geralmente não acrescentam significado. Procure fragmentos repetidos e remova-os de forma consistente, tomando cuidado para não excluir uma frase que também faça parte do conteúdo real.

  • Reduza sequências de três ou mais linhas em branco fora de blocos de código.
  • Junte palavras divididas apenas pela hifenização de fim de linha de PDF.
  • Exclua textos de navegação ou legais padrão repetidos em todas as páginas.
  • Remova títulos vazios e itens de lista vazios.

Reconstrua um esboço lógico de títulos

Use um H1 para o título do documento. Seções principais geralmente usam H2, subseções H3 e assim por diante. Não pule níveis apenas para obter um estilo visual menor; a apresentação pertence ao renderizador.

PDFs convertidos podem marcar linhas em negrito como títulos de forma agressiva demais, enquanto documentos do Word com formatação manual podem não marcá-las de forma alguma. Leia o esboço como um sumário e ajuste os níveis com base no significado.

Antes e depoisMarkdown
Before:
# Deployment
#### Prerequisites
## Linux

After:
# Deployment
## Prerequisites
### Linux

Normalize listas e espaçamento

Use um único estilo de marcador para itens não ordenados e recuo consistente para o aninhamento. Mantenha uma linha em branco antes e depois de uma lista, mas evite linhas em branco entre cada item curto, a menos que cada item contenha vários parágrafos.

Um conversor pode confundir títulos numerados ou células de tabela com itens de lista. Confirme se a numeração ordenada carrega significado em vez de refletir um rótulo de página da fonte.

Simplifique tabelas para telas estreitas e legibilidade da fonte

Verifique se cada linha tem o mesmo número de células e se caracteres de pipe dentro do conteúdo estão com escape. Encurte cabeçalhos verbosos, mova explicações longas para baixo da tabela e divida grupos de colunas não relacionados.

Células mescladas, tabelas aninhadas, gráficos e fórmulas de planilha não têm equivalente confiável em tabelas Markdown. Substitua-os por uma lista, várias tabelas pequenas, um resumo em texto ou um link para dados-fonte mantidos.

Verifique links, imagens e código

Links relativos herdados de HTML ou EPUB dependem da localização original. A extração de PDF pode dividir URLs, e documentos do Office podem conter texto de exibição cujo destino mudou. Abra cada link importante no destino final.

Adicione texto alternativo descritivo às imagens mantidas. Confirme se o código com cerca tem a linguagem correta e se caracteres especiais não foram transformados tipograficamente. Nunca execute comandos copiados até que tenham sido revisados como conteúdo não confiável.

Termine com significado, não com aparência

Compare nomes, datas, quantidades, código e decisões com a fonte. Reescreva frases que dependiam da posição na página, dos recursos visuais do slide ou da cor da planilha. Depois pré-visualize em larguras de desktop e estreitas, baixe o arquivo .md e valide-o no sistema de publicação.

Uma conversão limpa deve ser lida naturalmente como um documento escrito em Markdown, mesmo quando o original permanece o registro autoritativo.

Limpe a próxima conversão em um único espaço de trabalho

Abra um rascunho convertido, compare a fonte e a pré-visualização e depois copie ou baixe o Markdown revisado.

Converter um arquivo suportado