Definir o que será entregue
Um artigo pode exigir títulos, prosa, listas e rótulos; a conferência do código-fonte pode incluir sintaxe, URLs e programas. Antes de limpar, registre o escopo: “artigo convertido, título incluído, código excluído” ou “fonte completa entregue”. O contador mede o conteúdo colado. Divergir da prévia não prova sozinho uma falha na identificação de palavras.
Títulos podem mudar caracteres sem mudar palavras
O literal italiano ## Gatto **nero** tem dezessete caracteres e duas palavras neste motor; Gatto nero, dez e duas. Isso não demonstra que todo Markdown conserve palavras. Outras construções acrescentam destinos ou termos técnicos, e asteriscos podem ser conteúdo literal. CommonMark define essas funções: confira a prévia real e os casos ambíguos antes de apagar símbolos.
Separar rótulos e URLs
O literal [Leggi qui](https://esempio.test/guida) tem trinta e nove caracteres e seis palavras aqui. O rótulo visível Leggi qui tem nove e duas; termos adicionais vêm da segmentação da URL. Combine se destinos entram em limites ou cobrança. Definições de referência fora do corpo não pertencem automaticamente a uma cópia de prosa. Examine links reais, inclusive seus títulos descritivos.
Decidir quais códigos entram
Variáveis, comentários, cadeias e comandos podem ser trabalho editorial, demonstrações ou anexos. Para limite de prosa, exclua blocos e registre a decisão. Um timeout numa instrução pode ser essencial mesmo excluindo uma listagem longa. Distinga cercas, citações e indentação. Extensões além de CommonMark exigem conferir a publicação de destino, não apenas um arquivo de exemplo.
Texto alternativo e legendas
A referência de imagem contém descrição alternativa e caminho; nenhum deles é automaticamente uma legenda visível. Inventários de acessibilidade podem medir descrições separadamente. Separe corpo, legendas, alternativas e metadados para evitar duplicações na conversão. Palavras desenhadas talvez não existam no Markdown: transcreva as necessárias e identifique a origem, sem deduzir conteúdo pelo nome do arquivo.
Preparar uma cópia legível
Converta no ambiente de destino, selecione o escopo combinado e copie como texto. Confira títulos, listas e links: os separadores transferidos variam. Trabalho recorrente pode precisar de analisador compatível. Apagar tudo entre parênteses elimina explicações e fórmulas; retirar todo # ou * danifica exemplos literais. Releia código, links e citações após a conversão.
Conferir extensões do formato
A extensão .md não determina como tabelas, notas e metadados serão tratados. Um conversor os interpreta; outro mostra texto bruto. Defina ambiente de referência e exclusões. Não conte duas vezes um título também exibido a partir de metadados. Em tabelas, declare células e colunas incluídas, sobretudo códigos de produto que podem ter tratamento diferente da prosa.
Explicar diferenças de escopo
Mantenha cópias separadas e identificadas de fonte e texto editorial quando ambas importarem. Diferenças concentradas em URLs ou listagens apontam inclusões a revisar, sem alterar a prosa. Antes da entrega, confira título com ênfase, link e bloco de código reais. Totais podem diferir quando cada causa está explicada. Consulte a contagem do texto HTML.
Fonte e texto legível separados
| Amostra | Caracteres no site | Palavras no site | Inclui |
|---|---|---|---|
| ## Gatto **nero** | 17 | 2 | Sintaxe de título e ênfase |
| Gatto nero | 10 | 2 | Texto legível |
| [Leggi qui](https://esempio.test/guida) | 39 | 6 | Rótulo e URL |
| Leggi qui | 9 | 2 | Somente rótulo |
Fontes e verificações
- CommonMark Specification 0.31.2 · Defina se mede o código Markdown ou o texto convertido e confira links, blocos de código e imagens.