markdownlint-cli2 0.10.0 → 0.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +6 -0
- package/README.md +15 -8
- package/markdownlint-cli2.js +370 -322
- package/package.json +14 -17
- package/resolve-and-require.js +3 -3
- package/schema/markdownlint-cli2-config-schema.json +10 -0
- package/schema/markdownlint-config-schema.json +840 -186
package/CHANGELOG.md
CHANGED
package/README.md
CHANGED
|
@@ -167,12 +167,12 @@ A container image [`davidanson/markdownlint-cli2`][docker-hub-markdownlint-cli2]
|
|
|
167
167
|
can also be used (e.g., as part of a CI pipeline):
|
|
168
168
|
|
|
169
169
|
```bash
|
|
170
|
-
docker run -v $PWD:/workdir davidanson/markdownlint-cli2:v0.
|
|
170
|
+
docker run -v $PWD:/workdir davidanson/markdownlint-cli2:v0.11.0 "**/*.md" "#node_modules"
|
|
171
171
|
```
|
|
172
172
|
|
|
173
173
|
Notes:
|
|
174
174
|
|
|
175
|
-
- As when using the [command line]
|
|
175
|
+
- As when using the [command line][command-line], glob patterns are passed as
|
|
176
176
|
arguments.
|
|
177
177
|
- This image is built on the official [Node.js Docker image][nodejs-docker].
|
|
178
178
|
Per security best practices, the [default user `node`][nodejs-docker-non-root]
|
|
@@ -184,7 +184,7 @@ Notes:
|
|
|
184
184
|
- A custom working directory can be specified with Docker's `-w` flag:
|
|
185
185
|
|
|
186
186
|
```bash
|
|
187
|
-
docker run -w /myfolder -v $PWD:/myfolder davidanson/markdownlint-cli2:v0.
|
|
187
|
+
docker run -w /myfolder -v $PWD:/myfolder davidanson/markdownlint-cli2:v0.11.0 "**/*.md" "#node_modules"
|
|
188
188
|
```
|
|
189
189
|
|
|
190
190
|
> **Deprecated**
|
|
@@ -193,7 +193,7 @@ Notes:
|
|
|
193
193
|
> instead, use Docker's `--entrypoint` flag:
|
|
194
194
|
>
|
|
195
195
|
> ```bash
|
|
196
|
-
> docker run -v $PWD:/workdir --entrypoint="markdownlint-cli2-fix" davidanson/markdownlint-cli2:v0.
|
|
196
|
+
> docker run -v $PWD:/workdir --entrypoint="markdownlint-cli2-fix" davidanson/markdownlint-cli2:v0.11.0 "**/*.md" "#node_modules"
|
|
197
197
|
> ```
|
|
198
198
|
|
|
199
199
|
For convenience, the container image
|
|
@@ -231,6 +231,8 @@ of the rules within.
|
|
|
231
231
|
- When glob expressions match files *not* under the current directory,
|
|
232
232
|
configuration for the current directory is applied to the closest common
|
|
233
233
|
parent directory.
|
|
234
|
+
- Paths beginning with `~` are resolved relative to the user's home directory
|
|
235
|
+
(typically `$HOME` on UNIX and `%USERPROFILE%` on Windows)
|
|
234
236
|
- There are two kinds of configuration file (both detailed below):
|
|
235
237
|
- Configuration files like `.markdownlint-cli2.*` allow complete control of
|
|
236
238
|
`markdownlint-cli2` behavior and are also used by `vscode-markdownlint`.
|
|
@@ -305,6 +307,8 @@ of the rules within.
|
|
|
305
307
|
- Relative paths are resolved based on the location of the `JSONC` file
|
|
306
308
|
- For example: `[ [ "plugin-name", param_0, param_1, ... ], ... ]`
|
|
307
309
|
- Search [`markdown-it-plugins` on npm][markdown-it-plugins]
|
|
310
|
+
- `modulePaths`: `Array` of `String`s providing additional paths to use when
|
|
311
|
+
resolving module references (e.g., alternate locations for `node_modules`)
|
|
308
312
|
- `noInlineConfig`: `Boolean` value to disable the support of
|
|
309
313
|
[HTML comments][html-comment] within Markdown content
|
|
310
314
|
- For example: `<!-- markdownlint-disable some-rule -->`
|
|
@@ -348,7 +352,7 @@ of the rules within.
|
|
|
348
352
|
|
|
349
353
|
- The format of this file is a [CommonJS module][commonjs-module] (`.cjs`) or
|
|
350
354
|
[ECMAScript module][ecmascript-module] (`.mjs`) that exports the object
|
|
351
|
-
described above for `.markdownlint-cli2.jsonc
|
|
355
|
+
described above for `.markdownlint-cli2.jsonc` (directly or from a `Promise`).
|
|
352
356
|
- Instead of passing a `String` to identify the module name/path to load for
|
|
353
357
|
`customRules`, `markdownItPlugins`, and `outputFormatters`, the corresponding
|
|
354
358
|
`Object` or `Function` can be provided directly.
|
|
@@ -388,7 +392,8 @@ of the rules within.
|
|
|
388
392
|
|
|
389
393
|
- The format of this file is a [CommonJS module][commonjs-module] (`.cjs`) or
|
|
390
394
|
[ECMAScript module][ecmascript-module] (`.mjs`) that exports the
|
|
391
|
-
[`markdownlint` `config` object][markdownlint-config]
|
|
395
|
+
[`markdownlint` `config` object][markdownlint-config] (directly or from a
|
|
396
|
+
`Promise`).
|
|
392
397
|
- Other details are the same as for `jsonc`/`json` files described above.
|
|
393
398
|
- For example: [`.markdownlint.cjs`][markdownlint-cjs] or
|
|
394
399
|
[`.markdownlint.mjs`][markdownlint-mjs]
|
|
@@ -415,7 +420,7 @@ reference to the `repos` list in that project's `.pre-commit-config.yaml` like:
|
|
|
415
420
|
|
|
416
421
|
```yaml
|
|
417
422
|
- repo: https://github.com/DavidAnson/markdownlint-cli2
|
|
418
|
-
rev: v0.
|
|
423
|
+
rev: v0.11.0
|
|
419
424
|
hooks:
|
|
420
425
|
- id: markdownlint-cli2
|
|
421
426
|
```
|
|
@@ -425,8 +430,10 @@ reference to the `repos` list in that project's `.pre-commit-config.yaml` like:
|
|
|
425
430
|
|
|
426
431
|
## History
|
|
427
432
|
|
|
428
|
-
See [CHANGELOG.md]
|
|
433
|
+
See [CHANGELOG.md][changelog].
|
|
429
434
|
|
|
435
|
+
[changelog]: CHANGELOG.md
|
|
436
|
+
[command-line]: #command-line
|
|
430
437
|
[commonmark]: https://commonmark.org/
|
|
431
438
|
[commonjs-module]: https://nodejs.org/api/modules.html#modules_modules_commonjs_modules
|
|
432
439
|
[ecmascript-module]: https://nodejs.org/api/esm.html#modules-ecmascript-modules
|