A Polysh para agentes está em acesso antecipado. Seu agente de programação grava a demo, e a Polysh finaliza. Entrar na lista de espera →

Contador de palavras em Markdown

Tenha a contagem real de palavras de um Markdown, com títulos, links e imagens.

Carregando a ferramenta no navegador…

O que faz: Contador de palavras em Markdown

Um contador de palavras comum trata **, ##, endereços de links e exemplos de código como palavras, então um artigo de ajuda ou um README em Markdown parece mais longo do que é na leitura. Aqui o documento é renderizado antes da contagem, o que dá o número que o leitor realmente vê.

Use para manter páginas de documentação dentro de uma meta de tamanho, comparar dois rascunhos ou conferir se um tutorial não é quase só código. Ao lado do total de palavras aparecem as contagens de títulos, links, imagens e blocos de código, e um tempo de leitura a 200 palavras por minuto.

Exemplo

Entrada

# Gravar uma demo

Abra o [gravador](https://polysh.io/product/recorder/) e pressione **Iniciar**.

```bash
npm run dev
```

![Barra de ferramentas](toolbar.png)

O relatório mostra

Palavras: 9 (cerca de 1 minuto de leitura)
Títulos: 1
Links: 1
Imagens: 1
Blocos de código: 1

Só o título e a frase são contados. O endereço do link, o bloco de código e o texto alternativo da imagem não somam nada ao total.

Como usar: Contador de palavras em Markdown

  1. Cole o Markdown, ou clique em Abrir arquivo para carregar um arquivo .md.
  2. Deixe Não contar o código ativado para contar só o texto, ou desative para incluir o código.
  3. Veja o bloco Palavras e os totais ao lado.

Bom saber

  • Deixar o código de fora também remove código inline como npm install, então uma frase que cita um comando fica com uma ou duas palavras a menos.
  • O texto alternativo das imagens nunca é contado, embora os leitores de tela o leiam em voz alta.
  • O tempo de leitura usa 200 palavras por minuto fixas. Guias passo a passo que as pessoas seguem clicando levam mais tempo; a Calculadora de tempo de leitura deixa você definir o ritmo.

Perguntas sobre Contador de palavras em Markdown

Como conto as palavras de um arquivo Markdown?

Cole o arquivo ou clique em Abrir arquivo. O bloco Palavras mostra a contagem do texto visível, sem os símbolos do Markdown, os endereços dos links e o código. Desative Não contar o código se a sua meta inclui os exemplos de código.

Qual deve ser o tamanho de um artigo de central de ajuda?

A maioria dos artigos de tarefa funciona bem entre 300 e 800 palavras: o suficiente para os passos e uma ou duas capturas de tela, curto o bastante para ler rapidamente. Acima de umas 1.500 palavras, geralmente são vários artigos que deveriam responder a uma pergunta cada.

A contagem inclui os títulos?

Sim. O texto dos títulos faz parte do que o leitor vê, então as palavras dele contam. O bloco Títulos mostra separadamente quantos títulos o documento tem, o que ajuda ao conferir a estrutura.

Por que a contagem é menor que a do meu editor?

Muitos editores contam o arquivo bruto, com URLs, símbolos e código. Este contador conta só o texto renderizado, então a diferença é maior em documentos com muitos links ou blocos de código.