unified

Project:remarkjs/remark-lint

Package:remark-lint-ordered-list-marker-value@1.0.4

  1. Dependencies:4·Dependents:16
  2. remark-lint rule to warn when the marker value of ordered lists violates a given style
  1. remark 165
  2. lint 70
  3. rule 64
  4. marker 13
  5. list 9
  6. ordered 3

remark-lint-ordered-list-marker-value

Build Coverage Downloads Size Sponsors Backers Chat

Warn when the list item marker values of ordered lists violate a given style.

Options: 'single', 'one', or 'ordered', default: 'ordered'.

When set to 'ordered', list item bullets should increment by one, relative to the starting point. When set to 'single', bullets should be the same as the relative starting point. When set to 'one', bullets should always be 1.

Fix

remark-stringify retains the number of the first list item bullet, and by default increments the other items. Pass incrementListMarker: false to not increment further list items.

See Using remark to fix your Markdown on how to automatically fix warnings for this rule.

Presets

This rule is included in the following presets:

PresetSetting
remark-preset-lint-markdown-style-guide'one'

Example

valid.md
In
The default value is `ordered`, so unless changed, the below
is OK.

1.  Foo
2.  Bar
3.  Baz

Paragraph.

3.  Alpha
4.  Bravo
5.  Charlie

Unordered lists are not affected by this rule.

*   Anton
Out

No messages.

valid.md

When configured with 'one'.

In
1.  Foo
1.  Bar
1.  Baz

Paragraph.

1.  Alpha
1.  Bravo
1.  Charlie
Out

No messages.

invalid.md

When configured with 'one'.

In
1.  Foo
2.  Bar
Out
2:1-2:8: Marker should be `1`, was `2`
also-invalid.md

When configured with 'one'.

In
2.  Foo
1.  Bar
Out
1:1-1:8: Marker should be `1`, was `2`
valid.md

When configured with 'single'.

In
1.  Foo
1.  Bar
1.  Baz

Paragraph.

3.  Alpha
3.  Bravo
3.  Charlie

Paragraph.

0.  Delta
0.  Echo
0.  Foxtrot
Out

No messages.

valid.md

When configured with 'ordered'.

In
1.  Foo
2.  Bar
3.  Baz

Paragraph.

3.  Alpha
4.  Bravo
5.  Charlie

Paragraph.

0.  Delta
1.  Echo
2.  Foxtrot
Out

No messages.

invalid.md

When configured with 'ordered'.

In
1.  Foo
1.  Bar
Out
2:1-2:8: Marker should be `2`, was `1`
invalid.md

When configured with 'invalid'.

Out
1:1: Invalid ordered list-item marker value `invalid`: use either `'ordered'` or `'one'`

Install

npm:

npm install remark-lint-ordered-list-marker-value

Use

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

 ...
 "remarkConfig": {
   "plugins": [
     ...
     "lint",
+    "lint-ordered-list-marker-value",
     ...
   ]
 }
 ...

Or use it on the CLI directly

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

Contribute

See contributing.md in remarkjs/.github for ways to get started. See support.md for ways to get help.

This project has a Code of Conduct. By interacting with this repository, organisation, or community you agree to abide by its terms.

License

MIT © Titus Wormer