Markdown Links

Herramienta ejecutable en línea de comando (CLI), desarrollada en Node.js, entorno de ejecución para JavaScript, para validar dentro de archivos .md los links existentes. Asegúrate de tener creado un package.json en donde instalarás esta librería.

1. Instalación

npm i markdown-links-yh

2. Uso

1) API

El módulo debe poder importarse en otros scripts de Node.js de la siguiente manera:

const mdLinks = require("markdown-links-yh");

mdLinks(path, options)

Argumentos

• path: Ruta absoluta o relativa al archivo o directorio.

• options: Un objeto con únicamente las siguientes propiedades:

  • validate: Booleano que determina si se desea validar los links encontrados.
  • stats: Booleano que determina si se desea obtener un output con información estadística general.

Valor de retorno

Con validate:false :

[
  {
    href: 'https://es.wikipedia.org/wiki/Markdown',
    text: 'Markdown',
    file: 'D:\\Bootcamp_laboratoria\\Proyectos\\markdown-links-yh\\test\\testFolder\\hi.md'
  },
]

Con validate:true :

[
  {
    href: 'https://es.wikipedia.org/wiki/Markdown',
    text: 'Markdown',
    file: 'D:\\Bootcamp_laboratoria\\Proyectos\\markdown-links-yh\\test\\testFolder\\hi.md',
    status: 200,
    message: 'ok'
  }, 
     {
    href: 'https://0es.wikipedia.org/wiki/Markdown',
    text: 'kembeck',
    file: 'D:\\Bootcamp_laboratoria\\Proyectos\\markdown-links-yh\\test\\testFolder\\hi.md',
    status: 500,
    message: 'fail'
  },
]

Con validate:true stats:true :

{ Total: 5, Unique: 5, Broken: 3 }

Con validate:false stats:true :

{ Total: 5, Unique: 5 }

Ejemplo

const mdLinks = require("markdown-links-yh");
const options = {
    validate: process.argv.includes('--validate'),
    stats: process.argv.includes('--stats')
}

mdLinks("./some/example.md", options)
  .then(links => {
    // => [{ href, text, file }, ...]
  })
  .catch(console.error);

mdLinks("./some/example.md", { validate: true })
  .then(links => {
    // => [{ href, text, file, status, ok }, ...]
  })
  .catch(console.error);

mdLinks("./some/dir")
  .then(links => {
    // => [{ href, text, file }, ...]
  })
  .catch(console.error);

Ejecútalo ejecutando en consola: node <nombre del archivo donde lo has requerido> argumento path, argumento options

2) CLI

En terminal CLI: Asegurate de que tus archivos .js estén configurados para ejecutarse con node.js.

Instala de manera global

npm i markdown-links-yh -g

Ejecuta el comando mdLinks directamente en consola, de acuerdo al siguiente ejemplo:

$ mdLinks ./some/example.md
./some/example.md http://algo.com/2/3/ Link a algo
./some/example.md https://otra-cosa.net/algun-doc.html algún doc
./some/example.md http://google.com/ Google

Valor de retorno

Options

--validate

$ mdLinks ./some/example.md --validate
./some/example.md http://algo.com/2/3/ ok 200 Link a algo
./some/example.md https://otra-cosa.net/algun-doc.html fail 404 algún doc
./some/example.md http://google.com/ ok 301 Google

--stats

$ mdLinks ./some/example.md --stats
Total: 3
Unique: 3

--stats --validate

$ mdLinks ./some/example.md --stats --validate
Total: 3
Unique: 3
Broken: 1

## Autor
##### Yaneth Hernández