#404 · Markdown y documentos

Contador de palabras en comentarios de código

Mide cuánto texto explicativo hay dentro de comentarios de código. El análisis detecta comentarios de línea y de bloque habituales, extrae su contenido y calcula palabras y líneas comentadas sin contar instrucciones del programa.

Entrada de texto

Código con comentarios
Espacio publicitario

Cómo usar esta herramienta de texto

  1. Pega o escribe el contenido en el área de entrada.
  2. Ajusta las opciones disponibles si necesitas cambiar el comportamiento.
  3. Pulsa el botón principal o usa Ctrl/Cmd + Enter.
  4. Revisa el resumen, las métricas y el resultado antes de copiarlo o descargarlo.

Qué hace esta herramienta

Procesa el contenido con reglas específicas del formato y genera una salida más estructurada o un análisis cuantificable.

Se extraen patrones comunes de comentarios de línea y bloque y el conteo se realiza solo sobre ese contenido.

El resultado se genera en tu navegador. Revisa siempre el contenido antes de publicarlo o usarlo en producción.

Ejemplo

Entrada:

// Inicializa la aplicación
const app = start();
/* Reintenta la conexión
   si falla la primera vez */

Resultado: ejecuta el ejemplo incorporado para ver una salida verificable con las mismas reglas del procesador.

Casos de uso

  • Revisión rápida antes de publicar documentación.
  • Normalización de contenido pegado desde distintas fuentes.
  • Comprobación local sin depender de servicios externos.

Consejos para obtener mejores resultados

  • Usa una entrada suficientemente representativa.
  • Conserva una copia del original antes de reemplazar contenido.
  • Revisa nombres propios, código y valores sensibles tras el procesamiento.
  • Prueba casos límite si el resultado se integrará en un flujo automatizado.

Detalles del procesamiento

El procesamiento se ejecuta localmente con JavaScript y opera sobre el texto visible en el navegador. No requiere una API externa.

El análisis se basa en patrones y no sustituye un parser, compilador o detector especializado cuando se necesita validación normativa completa.

Preguntas frecuentes

¿Qué tipos de comentarios de código reconoce el contador?

Reconoce comentarios //, bloques /* ... */ y líneas que comienzan con #, por lo que cubre casos frecuentes de JavaScript, CSS, C y Python.

¿Las palabras del código ejecutable se incluyen en el total?

No. El contador extrae primero los comentarios detectados y calcula las palabras únicamente sobre ese contenido.

¿Puede confundir // dentro de una URL o una cadena?

Sí. El análisis es heurístico y no implementa un parser completo de cada lenguaje, por lo que algunos marcadores dentro de cadenas podrían interpretarse como comentarios.

¿Cuenta comentarios de varias líneas?

Sí. Los bloques /* ... */ se contabilizan como un comentario y también se registran sus líneas.

¿Puedo usarlo para medir documentación interna de un proyecto?

Sí, como estimación rápida. Para métricas exactas por lenguaje conviene usar un parser específico del lenguaje.

Resumen de módulos

MóduloFunción
EntradaTexto pegado, escrito o cargado desde archivo
ProcesamientoReglas específicas del tipo de herramienta
SalidaResultado copiable y descargable