MD-LINKS by Sonia Reyes

"md-links" es un módulo que te ayudará a verificar links de archivos .md, y validar si funcionan o están rotos.

¿Donde lo encuentro?

Puedes ver la documentación oficial de este paquete en NPM: @soniarez/md-links

¿Cómo instalarlo?

Debes abrir la terminal desde la carpeta del proyecto donde quieres instalarlo. Otra forma, es hacerlo en la carpeta del proyecto desde la terminal con los comandos necesarios (ejemplo: cd,ls, etc.)

Nivel local

npm i @soniarez/md-links

Nivel global

npm install @soniarez/md-links -g

¿Cómo funciona?

Al ejecutar md-links en la terminal, acompañado de la ruta que deseas evaluar, te devuelverá una promesa con un resultado que corresponde a un arreglo de objetos.

Valor de retorno:

• href: URL encontrada.
• text: Texto que aparecería dentro del link
• file: Ruta del archivo donde se encontró el link.

--validate (como argumento)

Si incluyes el argumento --validate, te entregará lo siguiente:

• href: URL encontrada.
• text: Texto que aparecía dentro del link ().
• file: Ruta del archivo donde se encontró el link.
• status: Código de respuesta HTTP.
• statusText: Mensaje Not found en caso de fallo u ok en caso de éxito.

--stats (como argumento)

Si pasas la opción --stats el output (salida) será un texto con estadísticas básicas sobre los links.

• total: número de links en el archivo evaluado.
• unique: número de links únicos (no repetidos).

Ejemplo de uso en terminal

Escribe en la terminal:

md-links [ruta del archivo a evaluar] --validate

Y mostrará algo así:

[ { 
    href:  "https://es.wikipedia.org/wiki/Markdown",

    text: Markdown,
    file: https://es.wikipedia.org/wiki/Markdown
    status: 200
    statusText: Ok }
  { href: 'https://developers.google.com/v8/',
  
    text: Motor de JavaScript V8 de Chrome,
    file: https://v8.dev/xxxxxx
    status: 404
    statusText: Not found }]

Con --stats:

md-links [ruta del archivo a evaluar] --stats
Total: 3
Unique: 3