mdast-lint-books-links

This mdast-lint rule was created for free-programming-books-lint to enforce free-programming-books formatting guidelines.

This rule only applies to list items starting with a link. It enforces the following things:

• If an author is mentioned, it's done with - (a dash surrounded by single spaces)

BAD : * [Another Awesome Book - John Doe](http://example.com/book.html)
BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe
GOOD: * [Another Awesome Book](http://example.com/book.html) - John Doe

• There's a single space between the link and its format

BAD : * [Another Awesome Book](http://example.com/book.pdf)(PDF)
GOOD: * [Another Awesome Book](http://example.com/book.pdf) (PDF)

• Author comes before format:

BAD : * [Another Awesome Book](http://example.com/book.pdf)- John Doe
GOOD: * [Another Awesome Book](http://example.com/book.pdf) - John Doe (PDF)

Using the rule

Via .mdastrc

npm install -g mdast
npm install -g mdast-lint
npm install mdast-lint-books-links # local install!

Then, set up your .mdastrc:

{
  "plugins": {
    "mdast-lint": {
      "external": ["mdast-lint-books-links"]
    }
  }
}

Now you can use the following command to run the lint:

mdast --no-stdout xxx.md

Via CLI

npm install -g mdast
npm install -g mdast-lint
npm install -g mdast-lint-books-links # global install!
mdast --no-stdout -u mdast-lint="external:[\"mdast-lint-books-links\"]" xxx.md

Note that the lint=<lint_options> option only works with mdast >= 1.1.1.

This README.md is based on this one by @chcokr (MIT).