remark-lint-no-shortcut-reference-image

remark-lint-no-shortcut-reference-image

Warn when shortcut reference images are used.

Shortcut references render as images when a definition is found, and as plain text without definition. Sometimes, you don’t intend to create an image from the reference, but this rule still warns anyway. In that case, you can escape the reference like so: !\[foo].

Presets

This rule is included in the following presets:

Preset	Setting
remark-preset-lint-markdown-style-guide
remark-preset-lint-recommended

Example

valid.md

In

![foo][]

[foo]: http://foo.bar/baz.png

Out

No messages.

invalid.md

In

![foo]

[foo]: http://foo.bar/baz.png

Out

1:1-1:7: Use the trailing [] on reference images

Install

npm install remark-lint-no-shortcut-reference-image

Usage

You probably want to use it on the CLI through a config file:

 ...
 "remarkConfig": {
   "plugins": [
     ...
     "lint",
+    "lint-no-shortcut-reference-image",
     ...
   ]
 }
 ...

Or use it on the CLI directly

remark -u lint -u lint-no-shortcut-reference-image readme.md

Or use this on the API:

 var remark = require('remark');
 var report = require('vfile-reporter');

 remark()
   .use(require('remark-lint'))
+  .use(require('remark-lint-no-shortcut-reference-image'))
   .process('_Emphasis_ and **importance**', function (err, file) {
     console.error(report(err || file));
   });

License

MIT © Titus Wormer