remark-lint/packages/remark-lint-no-shell-dollars
Titus Wormer 282d27606d Refactor readme.mds
This commit rewrites most of the documentation per rule and preset,
`remark-lint` itself, and `unified-lint-rule`.

* Better and more readable automatic examples
* Check and update all rule descriptions
* Use middot (·) and line-feed (␊) for relevant examples
* Unify descriptions of `'consistent`'
* Add some more docs where needed

Closes GH-158.
2017-08-17 13:52:59 +02:00
..
index.js Refactor readme.mds 2017-08-17 13:52:59 +02:00
package.json 6.0.0 2017-02-23 18:34:08 +01:00
readme.md Refactor readme.mds 2017-08-17 13:52:59 +02:00

remark-lint-no-shell-dollars

Warn when shell code is prefixed by dollar-characters.

Ignores indented code blocks and fenced code blocks without language flag.

Presets

This rule is included in the following presets:

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

Example

valid.md
In
        ```sh
        echo a
        echo a > file
        ```

        ```zsh
        $ echo a
        a
        $ echo a > file
        ```

        Its fine to use dollars in non-shell code.

        ```js
        $('div').remove();
        ```
Out

No messages.

invalid.md
In
        ```bash
        $ echo a
        $ echo a > file
        ```
Out
1:1-4:4: Do not use dollar signs before shell-commands

Install

npm install remark-lint-no-shell-dollars

Usage

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

 ...
 "remarkConfig": {
   "plugins": [
     ...
     "lint",
+    "lint-no-shell-dollars",
     ...
   ]
 }
 ...

Or use it on the CLI directly

remark -u lint -u lint-no-shell-dollars 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-shell-dollars'))
   .process('_Emphasis_ and **importance**', function (err, file) {
     console.error(report(err || file));
   });

License

MIT © Titus Wormer