remark-lint-ordered-list-marker-value

remark-lint-ordered-list-marker-value

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:

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

Example

ok.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.

ok.md

When configured with 'one'.

In

1.  Foo
1.  Bar
1.  Baz

Paragraph.

1.  Alpha
1.  Bravo
1.  Charlie

Out

No messages.

not-ok.md

When configured with 'one'.

In

1.  Foo
2.  Bar

Out

2:1-2:8: Marker should be `1`, was `2`

also-not-ok.md

When configured with 'one'.

In

2.  Foo
1.  Bar

Out

1:1-1:8: Marker should be `1`, was `2`

ok.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.

ok.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.

not-ok.md

When configured with 'ordered'.

In

1.  Foo
1.  Bar

Out

2:1-2:8: Marker should be `2`, was `1`

not-ok.md

When configured with '💩'.

Out

1:1: Incorrect ordered list item marker value `💩`: 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, organization, or community you agree to abide by its terms.

License

MIT © Titus Wormer