mdlint

mdlint

Lint JavaScript code blocks in markdown files to find syntax errors.

Installation

npm install -g mdlint

Usage

mdlint is used as a command-line utility. It lints markdown files sourced from different locations using the following four commands:

mdlint <command> <arg> [options]

Commands:

repo  <user/repo>       lints a README from a GitHub repo
user  <username>        lints all READMEs from a user's GitHub repos
glob  <fileGlob>        lints local markdown files that match a file glob
query <query> [options] lints READMEs from repos returned by a GitHub query

Options:

--page=<pageNum> page of results to return from query command. Defaults to 0.
-s, --silent     only report failing lints
-h, --help       output usage information
-V, --version    output the version number

Sample Usage

Here is an example of mdlint being run on a GitHub repo's README file:

mdlint repo ChrisWren/grunt-pages

Here is an example of mdlint being run on all READMEs from a user's GitHub repos:

mdlint user ChrisWren

Here is an example of mdlint being run on a set of local files. Note that the glob expression must be wrapped in quotes as * is a special character in the terminal:

mdlint glob "docs/*.md"

Here is an example of mdlint being run on the collection of READMEs returned from page 2 of the grunt GitHub repositories search query:

mdlint query grunt --page=2

Usage with implicit commands

Any argument with a / will be interpreted as a GitHub repo, so you can lint a repo with the following shorthand command:

mdlint ChrisWren/grunt-nodemon

Any argument with a * or . will be interpreted as a local file glob, so you can lint a local file with the following shorthand command:

mdlint "README.md"

Any other argument will be intrepreted as a GitHub user, so you could lint all of a user's repos with the following shorthand command:

mdlint ChrisWren

Accepted JavaScript Partials

mdlint accepts certain pre-defined JavaScript partials which it will preprocess so that an error isn't thrown during syntax validation.

Object partials

gruntplugin: {
  
}

{
  key: 'value'
}

Function partials

function () {
  
}

Changelog

0.0.4 - Added support for implicit commands.

0.0.3 - Added ability to parse javascript code blocks.

0.0.2 - Made page parameter optional for query command.

0.0.1 - Added user command.

0.0.0 - Initial Release.