Markdown is a lightweight markup language very popular among developers. It is used in many platforms that handle plain text (GitHub, forums, blogs, ...) and it's very common to find several files in that format in any kind of repository (starting with the traditional README.md).
These Markdown files usually contain links (links) which are often broken or no longer or no longer valid and this greatly impairs the value of the information to be shared.
Within an open source community, we have been proposed to create a tool using Node.js, that reads and parses files in the Markdown format to verify the links they contain and report some statistics.
You can execute the commands on your favorite terminal. After typing the name of the package adamantine-links you put the relative path of your markdown file including the md extension as a first parameter to get the basic statistics: href, text and file (url, the clickeable text of that url and the file you're executing). The outcome will be an array of objects.
npm install adamantine-links -ghttps://github.com/Adamantine-art/markdown-links.gitAfter you have installed the package you can just execute adamantine-links to see the welcome message where you will be shown the commands you can use.
You can parse any .md file following this structure:
$ adamantine-links your-file.md --CLIoptions
Then the output will be an array of objects with all the links and their properties.
You can get more specific stats by using the following commands:
You get the additional properties of "status" and "ok".
You get the number of total and unique links inside the markdown file.
You can get the total number of links, unique and broken links inside the markdown file.
