Markdown es un lenguaje de marcado ligero muy popular entre developers. Estos archivos Markdown normalmente contienen links que muchas veces estan rotos o ya no son validos y eso perjudica mucho el valor de la informacion que se quiere compartir. Md-links-verification es una libreria que lee y analiza archivos en formato Markdown, ademas extrae y verifica los links que contengan.
Instalar como dependencia:
npm i md-links-verification
Instalar como interfaz
npm install -g https://github.com/Laboratoria/scl-2018-01-FE-markdown
El ejecutable de nuestra aplicación se ejecuta de la siguiente manera:
Linea que deberías ejecutar en tu terminal o consola:
mdlinks <file> [options]
Debes ingresar el archivo directo
Por ejemplo:
$ mdlinks example.md
./some/example.md:10 http://algo.com/2/3/ Link a algo
./some/example.md:15 https://otra-cosa.net/algun-doc.html algún doc
./some/example.md:40 http://google.com/ Google
Identifica el archivo markdown (a partir de la ruta que recibe como argumento), analiza el archivo Markdown e imprime los links que vaya encontrando, junto con la ruta del archivo y la linea donde aparece, así como también el texto que hay dentro del link.
mdlinks <file> --validate
$ mdlinks example.md --validate
./some/example.md:10 http://algo.com/2/3/ ok 200 Link a algo
./some/example.md:15 https://otra-cosa.net/algun-doc.html fail 404 algún doc
./some/example.md:40 http://google.com/ ok 301 Google
Vemos que el output en este caso incluye la palabra ok
o fail
después de
la URL, así como el status de la respuesta recibida a la petición HTTP a dicha
URL.
ccf3caa..4894bec master -> master ccf3caa..4894bec master -> master
- 1.0.0 Versión de prueba (sin funcionamiento)
- 1.0.1 Versión de prueba exportando mdLinks (sin funcionamiento)
- 1.0.2 Versión que ofrece instalación como dependencia
- 1.0.3 Versión con README
- 1.0.4 Versión con dependencias instaladas para ser instaladas a nivel global, readme actualizado.
- 1.0.5 Versión con test para cada función.